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1.  INTRODUCTION 


This  report  he*  three  Min  purposes.  The  first  is  to  document  the  Mthod  used 
by  the  Defense  Technical  InforMtion  Center  (DTIC)  to  convert  and  transfer 
text  files  from  its  Lanier  No  Problem  word  processors  to  its  Qould 
minicomputer  system.  The  second  is  to  docuMnt  an  implementation  of  the 
method  used  at  DTIC,  both  for  Mintaining  it  and  for  possible  use  of  it  or  a 
similar  one  elsewhere.  The  third  is  to  document  procedures  to  be  used  by 
operators  of  the  implementation. 

We  suggest  that  operators  read  sections  1  through  4  (skipping  Mtters  too 
technical)  to  gain  a  general  understanding  of  the  system,  and  then  concentrate 
on  the  parts  where  procedures  for  the  steps  of  the  conversion/transfer  process 
are  described  in  detail:  Appendices  C  through  E  and  section  5.3.  Appendix  B 
contains  important  background  InforMtion  for  understanding  Appendix  C. 
Maintainors  and  implementor*  My  wish  to  read  the  whole  report,  since  a  closer 
look  at  the  procedures  could  clarify  things  in  the  Min  body  of  the  the 
report . 

Section  1.1  gives  background  InforMtion.  Section  1.2  gives  an  overview  of 
the  conversion/transf er  process.  Section  1.3  describes  notation  used  in  this 
report.  Section  1.4  gives  the  order  of  presentation  in  the  rest  of  the 
document . 

1 . 1  Background 

The  DTIC  is  a  primary  level  field  activity  of  the  Defense  Logistics  Agency 
(DLA) .  A  text  transfer  effort  was  required  as  part  of  DTIC’s  participation  In 
a  DLA  conversion  from  various  kinds  of  equipMnt  and  systems  to  distributed 
minicomputer  systems.  The  new  systems  are  for  inforMtion  management,  office 
autoMtion  and  end-user  computing.  Each  DLA  Distributed  Minicomputer  System 
(DMINS)  provides  the  Q-One  word  processor  as  part  of  the  Q-Office  office 
autoMtion  software  package.  Before  its  DMINS  becaM  available,  DTIC  used 
Lanier  No  Problem  word  processors,  which  we  will  call  'Laniers.*  These  keep 
their  files  in  a  format  unacceptable  by  Q-One  and  on  diskettes  illegible  by 
microcomputers  or  other  available  devices.  The  transition  to  the  DMINS 
required  putting  the  Lanier  text  files  onto  a  standard  medium,  converting  them 
to  a  format  acceptable  by  Q-One,  transferring  them  to  the  DMINS,  and 
converting  them  to  Q-One  docuMntS. 

1.2  Overview  of  the  Lanier-to-DMINS  Conversion/Transfer  Process 

There  were  two  problems  with  transferring  text  files  from  our  Laniers  to  our 
DMINS.  One  problem  was  how  to  get  the  text  from  here  to  there,  that  is  from 
Lanier  diskettes  to  the  minicomputer.  So  the  first  problem  My  be  symbolized: 

LANIEB  ->  DMINS 

We  decided  to  do  this  by  using  the  one  DTIC  Lanier  equipped  for  data 
communication. 

The  second  problem  was  how  to  change  the  texts’s  forMt  from  Lanier  forMt  to 
Q-One  forMt.  This  My  be  symbolized: 

LIF  ->  QIF 
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where  LIF  weens  ‘Lanier  internal  foraat'  and  QIF  weans  ‘Q-One  internal 
format.'  ‘Internal  format'  here  weans  the  format  in  which  a  word  processor 
saves  a  document  after  someone  types  it. 

We  symbolise  both  problems  together  like  this: 

LAIIER(LIF)  ->  DIO  IS (QIF) 

Here  the  form  X(Y)  is  used,  where  X  is  a  system  and  Y  is  a  data  format  in  X. 

Whan  the  Lanier  communicates  a  text  file  to  another  system,  the  file's  format 
changes.  We  call  the  received  format  ‘Lanier  external  format'  (LEF) .  Since 
LEF  is  not  acceptable  by  Q-One,  we  convert  it  to  a  format  which  Q-One  accepts, 
namely  Document  Interchange  Format  (DIF),  which  is  sometimes  called  ‘levy  DIF’ 
to  distinguish  it  from  other  DIF  formats.  Q-One  itself  converts  DIF  files  to 
QIF.  So,  if  the  Lanier  were  to  send  a  file  directly  to  the  DMIIS,  the  process 
would  be: 

LAIIER(LIF)  ->  DMIIS (LEF)  ->  DMIIS (DIF)  ->  DMIIS (QIF) 

This  method  has  not  yet  been  tried,  and,  for  practical  reasons,  a  somewhat 
different  method  is  presently  being  used.  We  did,  however,  try  using  sx>dems 
and  telephone  lines  to  send  files  from  the  Lanier  to  a  VAX  minicomputer  and  a 
to  a  Sperry  Unlvac  mainframe  computer,  but  communication  frequently  stalled. 
Sender  and  receiver  remained  connected,  but  the  Lanier's  keyboard  locked. 

Since  we  saw  no  way  to  overcome  this,  we  decided  to  send  text  files  from  the 
Lanier  to  a  personal  computer  (PC) ,  and  then  send  them  from  the  PC  to  the 
DMIIS.  The  whole  proaess,  then,  includes  four  steps: 

13  3  4 

LAIIIS(LIF)  ~ >  PC (LIP)  — >  PC (DIF)  — >  DMIIS (DIF)  — >  DMIIS (QIF) 

LEF-to-DIF  conversion  is  done  in  a  PC,  and  DIF-to-QIF  conversion  is  done  in  a 
DMIIS.  Boldface,  underlining,  overstrike,  subscript  and  superscript  are 
preserved  by  the  process  (see  sections  5.1.2  and  5.2).  The 
conversion/transfer  process  is  described  more  fully  in  chapters  4  and  5  of 
this  report. 

1.3  lotatlon  Used  in  This  Report 

In  this  report  certain  things  are  represented  in  a  somewhat  unusual  ways 
Lanier  command  keyins  are  shown  with  plus  signs  and  spaces  which  are  not 
actually  typed.  For  example,  the  command  for  deleting  a  paragraph  from  the 
screen  is: 

SCRI  ♦  DEL  CHAR  ♦  P  ♦  EXEC 

where  SCRI  means  screen,  DEL  CHAR  means  delete  character,  P  means  paragraph, 
and  EXEC  means  execute.  This  command  requires  four  keypresses.  The 
abbreviations  are  those  which  are  printed  on  the  Lanier  key  tops.  On  the  DEL 
CHAR  key,  DEL  appears  above  CHAR.  This  key  is  used  not  only  to  delete  one 
character  but  also  in  comeutnds  which  delete  larger  items,  such  as  words  or 
paragraphs.  Again,  the  plus  signs  and  the  spaces  beside  them  are  not  typed. 

We  underline  key  names  to  show  that  one  key  and  not  a  sequence  of  keys,  such 
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as  S-C-B-B,  is  Mint. 

SoaetlMS  presses  of  CTRL  end  another  key  are  combined.  An  example  is  holding 
down  CTRL,  pressing  0,  and  then  releasing  both  keys.  We  show  this  sequence  as 
follows : 

k 

CRTL/0 

It  is  used  to  key  the  character  >  (greater  than)  into  the  Lanier.  The  forward 
[  slash  here  represents  holding  down  CTRL. 

F 

The  above  notations  are  modeled  on  the  ones  used  in  Lanier  manuals. 

The  Lanier  keyboard  is  described  in  section  2.1.1  below  (see  Figure  1). 

We  show  the  encoding  of  formatting  control  functions  as  sequences  of 
characters  in  the  American  Standard  Code  for  Information  Interchange  (ASCII) . 
Each  ASCII  character  sequence  is  shown  in  two  ways,  as  in  the  following 
>  example: 

t  ESC  [  S  H 

i.  IB  5B  24  46 

where  the  first  line  shows  the  character  itself  or  its  standard  abbreviation, 
k  and  the  second  line  shows  the  hexadecimal  code  for  the  character.  An 

abbreviation  is  shown  only  if  the  character  is  not  printable.  Thus  ESC 
represents  the  escape  character.  The  sixteen  hexadecimal  digits  are 
01 23456780 ABCDEF,  where  A  means  ten  and  F  means  15.  More  information  on  the 
ASCII  code  is  given  in  Appendix  A. 

We  often  capitalise  (a)  a  word  or  phrase  at  the  point  where  it  is  being 
defined,  and  (b)  a  command  or  file  name  or  other  item  in  running  text  or  an 
Indented  example  where  case  makes  no  difference  but  capitals  may  be  more 
readable . 

1.4  Order  of  Presentation 

Chapter  2  describes  the  hardware  and  software  used  in  the  conversion/transfer 
process.  Chapter  3  describes  the  four  data  formatB  involved:  LIF,  LEF,  DIF 
and  QIF.  Chapter  4  describes  the  two  data  transfers:  Lanier-to-PC  and  PC-to- 
DMINS.  Chapter  5  describes  the  data  format  conversions:  LIF-to-LEF,  LEF-to- 
DIF,  and  DIF-to-QIF.  Chapter  0  summarizes  this  report. 
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2.  HARDWARE  AMD  SOFTWARE  USED  IN  THE  TRANSFER/ COMVERSIOH  PROCESS 


This  faction  briefly  describee  the  hardware  end  software  used  in  the  Lanier- 
to-DllINS  conversion/ transfer  effort. 

Section  2.1  describes  the  Lanier  word  processor  hardware  and  software  used. 
Section  2.2  covers  the  PC  hardware  and  software  used.  Section  2.3  covers  the 
DLA  DMINS  hardware  and  software  used. 

2.1  Lanier  No  Problem  Word  Processor  Hardware  and  Software 

DTIC  has  several  Lanier  No  Problem  word  processors,  but  omy  one  is  equipped 
for  communications.  We  will  call  it  'the  Lanier.'  Sections  2.1.1  and  2.1.2 
cover  the  Lanier  No  Problem  hardware  and  software,  respectively. 

2.1.1  Lanier  No  Problem  Hardware 

The  Lanier  word  processor  used  in  the  conversion  effort  consists  of  a  main 
unit  and  a  printer.  The  printer  is  useful  but  not  essential  to  the  effort. 

The  main  unit  contains  a  communications  printed  circuit  board  with  an  RS-232 
Interface  and  a  cable  used  to  connect  it  with  a  modem  or  other  device.  This 
cable  is  connected  to  a  null  modem  cable  which  la  connected  to  the  RS-232 
connector  in  a  PC.  The  null  modem  reverses  the  transmit  data  and  receive  data 
wires,  as  is  required  when  a  PC  is  directly  connected  to  another  PC  or  similar 
device. 

The  Lanier  main  unit  has  a  keyboard,  a  CRT  screen,  and  two  5-1/4  inch  disk 
drives.  The  keyboard  has  most  of  the  usual  typewriter  keys,  a  set  of  five 
function  keys  on  the  left,  and  a  set  of  twelve  word  processing  function  keys 
on  the  right.  Figure  1  depicts  the  Lanier  keyboard  layout. 

The  following  ASCII  characters  are  not  on  the  keyboard: 

<  >  \  *  ’  (  :  )  “ 

Each  of  these  can,  however,  be  transmitted  by  bolding  down  CTRL  (or,  in  one 
case,  SHIFT)  and  pressing  another  key,  as  follows: 


Keyin 

Character 

CTRL/1 

1 

(grave  accent) 

CTRL/ 2 

** 

(tilde) 

CTRL/ 3 

( 

CTRL/ 4 

i 

CTRL/ 5 

) 

CTJL/0 

< 

CTRL/9 

) 

CTRL/- 

\ 

SHIFT/fl 

* 

(caret) 

where  SHIFT/8  is  ordinarily  the  cents  character,  which  is  not  an  ASCII 
character.  In  this  and  some  other  cases  the  key  is  associated  with  the 
character  by  a  communication  transmit  table  mapping  (see  section  2.1.2  below). 
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Following  are  the  Mining!  of  the  abbreviation*  in  the  depiction: 


BBX 

break 

FBMT 

format 

CHAB 

character 

IIS 

inaert 

CMC 

cowwunicatlon 

KEPT 

repeat 

CVCL 

cancel 

SCUM 

acreen 

COVT 

continue 

da 

down  arrow 

CTBL 

control 

la 

left  arrow 

DEL 

delete 

ra 

right  arrow 

me 

execute 

ua 

up  arrow 

FVC 

function 

ula 

upper  left  arrow 

whara  lowar  caaa  aymbola,  auch  a a  ua,  rapraaant  drawn  arrow*. 


Figure  1.  Laniar  Vo  Problem  Word  Procaaaor  Keyboard  Layout 

0 

■ - * 


To  use  tie  Lanier  one  Bust  put  a  program  disk  In  ita  upper  drive  and  load  and 
run  the  program.  Thia  can  be  dona  by  turning  the  machine  on,  or,  if  it  is  on, 
by  pushing  the  rad  boot  (load)  button  on  the  front  of  the  machine.  Each  disk 
drive  has  a  light  used  to  indicate  the  currant  drive.  This  is  the  upper  drive 
whan  a  program  starts.  The  currant  drive  may  be  changed  by  the  appropriate 
one  of  the  following  function  key  sequences: 

FILE  ♦  da  ♦  EXEC 
FILE  ♦  ua  ♦  EXEC 

2.1.2  Lanier  Vo  Problem  Software 

Section  2. 1.2.1  is  on  Lanier  Vo  Problem  word  processing  software,  section 

2. 1.2.2  is  on  Lanier  Vo  Problem  pages  and  texts,  and  section  2. 1.2.3  is  on  the 
Lanier  Vo  Problem  TTY-ASCII  data  communications  program. 

2. 1.2.1  Lanier  Vo  Problt-a  Word  Processing  Software. 

A  Lanier  Vo  Problem  machine  is  usually  used  for  word  processing.  To  do  thia  a 
word  processing  program  is  first  loaded  from  a  disk  and  run.  Such  a  program 
has  many  features  and  functions.  Here  we  consider  three  commands  relevant  to 
communicating  files.  These  are  the  commands  for  memorizing  a  page  (copying 
what's  in  the  Lanier's  screen  memory  to  a  disk),  for  recalling  a  page  from 
disk  to  screen  memory,  and  for  showing  the  index  (file  directory)  of  a  disk. 

A  page  in  Screen  memory  is  what  shows  on  the  CBT  screen  plus  what  is  off¬ 
screen  to  the  left  or  right  or  above  or  below.  The  arrow  keys  are  used  to 
bring  off-screen  symbols  into  view.  The  characters  of  approximately  one 
printed  page  can  be  kept  in  the  Lanier's  screen  memory  at  one  time.  Examples 
of  the  three  commands  are: 

FILE  ♦  M  ♦  ABC  ♦  EXEC 
FIL|  ♦  M  ♦  BHIC 
Fill  ♦  B  +  QHI  +  EXEC 
FILE  ♦  B  ♦  EXEC 
FILE  ♦  I  ♦  ISC 

where  M  swans  memorize,  B  means  recall,  I  means  index,  and  ABC  and  QHI  are 
names  given  to  pages.  The  last  command  displays  the  current  disk’s  file 
index,  which  names  each  page  and  shows  which  pages  are  connected  in  texts 
(explained  below)  by  putting  a  dividing  line  segment  between  page  names  not  in 
a  text  or  not  in  the  sasw  text.  This  divider  appears  as  a  fai  t  dot  followed 
by  spaces  to  the  end  of  the  nasi  column.  The  index  also  shows  the  number  of 
available  segments  the  disk  has. 

2. 1.2.2  Lanier  Vo  Problem  Pages  and  Texts 

Sets  of  pages  memorized  on  a  disk  can  be  combined  into  a  text.  A  TEXT  is  a 
set  of  connected  pages.  (We  will  not  consider  a  lone  page  to  be  a  special 
case  of  a  text.)  A  text  is  usually  built  by  typing  and  memorizing 
consecutively  two  or  more  pages,  specifying  a  name  only  in  the  first  memorize 
command.  The  names  of  the  pages  in  a  text  built  this  way  start  with  the  same 
character  sequence  but  eno  with  a  dot  and  a  sequence  number  (0,  1,  2,  and  so 
on).  If  you  do  not  put  a  dot  and  a  0  after  the  name  when  memorizing  the  first 
page  of  a  text,  the  index  display  will  not  show  them  for  this  page.  0-\  the 
other  hand,  if,  after  memorizing,  say,  page  VACATION  and  memorizing  two  more 
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pages  without  naming  tham,  you  type: 

FILE  ♦  M  ♦  VACATION. 3  *  EXEC 

paga  VACATION. 3  will  ba  a  aaparata  page  not  connected  to  text  VACATION. 

Imitating  I8M-D0S  terminology,  we  will  call  the  part  before  the  dot  the 
PAOENAME,  the  part  after  the  dot  the  EXTZiiSION,  and  the  combination  of  the  two 
with  a  dot  between  them  the  PAGE  SPECIFIER.  Thus  in  the  laat  example, 

VACATION  la  a  pagename,  3  ia  lta  extenaion,  and  VACATION. 3  ia  a  page 
apeclfier.  The  extenaion  muat  be  a  number  between  0  and  09.  If  there  ia  no 
extenaion,  the  pagename  and  page  apeclfier  are  the  aame.  A  text  ia  apecifled 
by  giving  the  paga  apeclfier  of  ita  flrat  page. 

Pages  with  name  extensions  between  the  lowest  and  the  highest  in  a  text  may  be 
missing  from  the  text,  due  to  the  way  the  text  was  formed.  For  example,  a 
text  might  consist  of  pages  SPEECH,  SPEECH. 1  and  SPEECH. 3.  Sometimes  pages 
with  the  same  pagename  and  different  extensions  are  not  in  the  same  text. 

Thus  D-D.1-D.2  and  D.7-D.8-D.9  might  be  two  different  texts.  A  case  of  a 
missing  page  can  result  from  use  of  a  delete  page  command,  as  in  the  following 
example: 


FILE  +  DEL  CHAR  ♦  P  ♦  SPEECH. 2 

A  text  can  be  augmented  by  inserting  one  or  more  separate  existing  pages  or 
texts.  For  this,  one  of  the  two  ‘combine*  commands  (file  Insert  page  or  file 
insert  text)  is  used.  For  example,  if  pages  X-X.1-X.2  are  a  text: 

FILE  ♦  INS  ♦  P  ♦  X. 3  X.l  +  EXEC 

would  put  X.3  in  text  X  between  X.l  and  X.2. 

Note  that  the  specifier  of  the  data  unit  (page  or  text)  to  be  inserted  is 
typed  before  the  specifier  of  the  text  page  after  which  it  is  to  be  inserted. 

For  another  example,  given  two  texts,  7  and  Z,  each  with  extensions  0,  1,2 
and  3,  in  that  order,  typing: 

FILE  ♦  INS  ♦  T  ♦  T.O  ♦  X.2  ♦  EXEC 

would  cause  text  X  to  contain  the  following  sequence  of  pages: 

X.0,  XI,  X.2,  7.0,  7.1,  7.2,  7.3,  X.3 

Text  7  would  cease  to  exist  as  a  separate  text  and  become  what  might  be  called 
a  'subtext'  of  text  X.  The  page  specifier  of  the  text  to  be  Inserted  need  not 
be  that  of  first  page  of  a  text.  Thus  if  7.1  were  used  instead  of  7.0  in  the 
previous  example,  the  resulting  text  X  would  contain  the  sequence: 

X.0,  X.l,  X.2,  7.1,  7.2,  7.3.  X.3 

and  7.0  would  exist  separately.  If  necessary,  use  combine  commands  to  fix  up 
a  text  before  trans'errlng  it  to  a  PC. 

See  section  B.l  of  Appendix  B  for  more  on  the  combine  comsmnds. 
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The  pagenames  of  the  pages  in  a  text  nay  all  ba  different,  and  the  extensions 
(if  any)  need  not  be  in  numeric  order. 

The  order  in  which  a  text's  pages  are  connected  on  their  disk  determines  the 
order  in  which  they  are  sent  when  the  text  is  transmitted  from  the  Lanier. 
Ordinarily  each  text  should  sent  to  a  different  PC  file. 

2. 1.2.3  The  Lanier  No  Problem  TTY- ASCI I  Data  Communications  Program 

The  Lanier  TTY-ASCII  data  communications  program  is  used  in  our  application. 

We  will  call  it  the  'TTY-ASCII  program.*  This  program  includes  two  editors 
which  can  do  some  of  the  functions  done  by  Lanier  No  Problem  word  processing 
programs  (see  section  B.l  of  Appendix  B) .  The  TTY-ASCII  program  is  loaded 
from  a  disk  Just  like  a  word  processing  program.  Then  it  may  be  removed. 

After  the  TTY-ASCII  program  is  loaded,  a  communication  table  must  be  loaded 
from  a  table  file  on  a  table  disk.  Then  the  table  disk  may  be  removed.  A 
communication  table  is  produced  by  ordinary  Lanier  word  process'ng.  The 
communication  table  we  use  is  COIMUWITAfi,  which  is  shown  in  Figure  2. 

The  TTY-ASCII  program  uses  the  communication  table  when  we  type  a  message  to  a 
receiver,  send  a  file,  or  receive  characters  from  a  sender.  Each 
communication  table  has  three  parts:  a  parameter  table,  a  transmit  table  and  a 
receive  table. 

The  PABAMETEB  TABLE  consists  of  three  rows  specifying  communications 
parameters  such  as  parity,  number  of  data  bits,  number  of  stop  bits,  speed, 
mode  (half  or  full  duplex),  end  of  line  sequence,  and  xon/xoff  options.  The 
values  of  these  parameters  in  a  given  table  file  depend  on  the  kind  of 
communication  to  be  done  and  the  kind  of  system  at  the  other  end  of  the 
comsninicatlon . 

The  TRANSMIT  TABLE  is  a  18  by  18  Mtrix  containing  a  cell  for  each  character 
code  which  the  Lanier  might  have  to  send.  The  first  and  second  hexadecimal 
digits  of  a  Lanier  internal  format  (LIF)  character’s  code  specify  the  row  and 
column  number  of  the  character's  cell  in  the  transmit  table.  Each  cell  in 
this  table  contains  a  two-digit  hexadecimal  number.  The  TTY-ASCII  program 
consults  this  table  each  time  it  has  a  character  to  send.  If  the  table  cell 
value  is  FF  (decimal  255),  no  character  is  sent.  Otherwise,  the  cell  value  is 
sent.  In  our  application,  only  seven  data  bits  are  transmitted,  so  no 
transmit  table  cell  value  (except  F7)  exceeds  7F  (decimal  127).  However,  the 
second  half  of  the  transmit  table  is  important,  since  the  Lanier  uses  eight 
bits  in  encoding  and  saving  pages  in  LIF.  Most  of  the  values  outside  the 
range  20  through  7F  (decimal  32  through  127)  have  nonstandard  meanings.  For 
example,  CK  (208)  represents  the  copyright  symbol.  We  made  some  application- 
specific  changes  in  the  transmit  table.  These  are  covered  in  section  5.1.1 
below. 

The  RECEIVE  TABLE  is  similar  to  the  transmit  table  but  is  only  half  as  large. 
This  table  was  much  less  important  to  our  application  than  the  transmit  table. 

The  numbers  within  the  transmit  and  receive  tables  must  be  separated  by 
special  spaces  produced  by  backspacing.  Such  a  space  shows  on  the  Lanier 
screen  as  a  faint  dot  in  the  middle  of  the  character’s  area. 


02  00  00  02  02  00  0A  01  2A  01  00  00  00  00  PP  01  Pi  la  COMMUXITAB  860922 

00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  Por  Laniar-to-PC 

El  00  05  ’LAXIEB  TYPIVQ  *  El  00  01  transfars  using 

REV.  2.1.1  TTT  Tabla 

FP  PP  PP  FP  PP  PP  PP  PP  IP  PP  OA  PF  FP  ID  PP  PP  Mod.  by  Rich  Thornatt 

PP  PP  PP  PP  PF  PP  PF  PP  PP  PP  PP  PF  PP  PP  PP  PP  EVEI  PARITY 

20  21  22  23  24  25  26  27  28  20  2A  2B  2C  2D  2E  2F  2400  BITS/SEC 

30  31  32  33  34  35  36  37  38  39  3A  3B  3C  3D  3E  3F  PULL  DUPLEX 

40  41  42  43  44  45  46  47  48  49  4A  4B  4C  4D  4E  4F  7  DATA  BITS 

50  51  52  53  54  55  56  57  58  59  5A  SB  SC  5D  51  5F  1  STOP  BIT 

60  61  62  63  64  65  66  67  68  69  6A  6B  6C  6D  6E  6F 

70  71  72  73  74  75  76  77  78  79  7A  7B  7C  7D  7E  PP  Bafora  sand  do: 

FP  PP  FP  FP  PF  PP  FP  PP  PP  PP  FP  FP  PP  PP  PP  PP  PRMT  ♦  H  ♦  144  ♦  EXXC 

FP  PP  FP  PP  FP  PP  PP  PP  PP  PP  PP  PP  5C  5E  OE  15  to’pracluda  truncation? 

FP  PP  PF  PP  PP  PP  PP  PP  PP  PP  PP  PP  PP  PP  PP  PP 

PP  PP  FP  FP  PP  FP  PP  PP  PP  PP  PP  PP  FP  PP  FP  PP 

08  PP  1C  7D  7B  7E  PP  PP  PP  PP  PP  PF  PF  PP  PP  FP 

OD  FP  PF  PF  FP  FP  FP  PP  PP  PP  PP  PP  PP  PP  FP  FP 

FP  OD  PP  IB  PF  PP  PF  PP  20  20  IE  PF  PF  PP  PF  PP 

PF  FF  FF  FF  FP  FP  PF  PF  PP  PP  PP  FP  PF  PP  FF  FP 

PP  PP  PP  PP  F7  IB  PB  PA  08  09  OA  1A  F6  El  F9  F8 

PP  1C  F3  IE  F4  PP  F5  PP  PP  PP  FP  PP  PP  PP  PP  FF 

20  21  22  23  24  25  26  27  28  29  2A  2B  2C  2D  2E  2F 

30  31  32  33  34  35  36  37  38  39  3A  3B  3C  3D  3E  3F 

40  41  42  43  44  45  46  47  48  49  4A  4B  4C  4D  4E  4F 

50  51  52  53  54  55  56  57  58  59  5A  08  5C  5D  5E  5F 

5C  61  62  63  64  65  66  67  68  69  6A  6B  6C  6D  6E  6F 

70  71  72  73  74  75  76  77  78  79  7A  7B  7C  7D  7E  PP 


Figura  2.  Comini  cat  ion  Tabla  for  Laniar  lo  Problaa  TTY- ASCI I 
Data  Comm  1  cat  ion*  Prograa 


The  following  command  load*  COMMUNITAB: 

FNC  +  L  ♦  COHIUMITAB  *  EXEC 

After  COMfUNITAB  is  loaded,  the  Laniar  communication  function  Bust  bo 
activated.  Then  the  PC  must  be  made  ready  to  receive  a  file.  When  this  is 
done,  the  Lanier  aust  be  told  to  send  a  page  or  a  text  or  the  whole  disk. 

(Tha  Lanier-to-PC  transfer  procedure  is  explained  in  Appendices  B  and  C.) 

2.2  Personal  Computer  Hardware  and  Software. 

Section  2.2.1  describes  the  Sperry  Onlvac  PC.  Section  2.2.2  covers  the  Zenith 
248  PC. 

2.2.1  Sperry  Uni vac  Personal  Computer  Hardware  and  Software. 

The  microcomputer  we  use  to  receive  files  from  the  Lanier  is  a  Sperry  Univac 
Personal  Computer  System,  which  we  will  call  the  ‘Sperry  PC.*  It  includes  a 
keyboard,  aonitor,  two  5-1/4  inch  disk  drives,  and  an  asynchronous 
coaauni cat ions  adapter  used  for  RS-232  type  communication.  The  Sperry  PC  is 
connected  through  a  null  aodea  cable  to  the  Lanier  (see  section  2.1.1).  The 
upper  and  lower  disk  drives  are  the  A  and  B  drives,  respectively. 

The  operating  system  used  in  the  PC  is  version  2.10  of  the  IBM  Disk  Operating 
System  (PC-DOS)  by  Microsoft  Inc.  PC-DOS  is  practically  the  same  as 
Microsoft’s  Disk  Operating  System  (MS-DOS).  We  will  call  the  operating  system 
used  MS-DOS.  Mlcroatuf  Inc.'s  Crosstalk  XVI  communications  program  is  used  in 
the  PC  to  receive  files  from  the  Lanier  and  can  be  used  to  send  files  to  a  DLA 
DMINS.  We  will  call  the  program  ‘Crosstalk  XVI. ‘  The  Kermit  file  transfer 
protoool  is  used  for  PC-to-DMIIS  transfers. 

An  introduction  to  Lanier-to-PC  file  transfers  is  given  in  Appendix  B.  A 
step-by-step  procedure  for  such  transfers  is  given  in  Appendix  C.  A  procedure 
for  converting  LEF  files  to  DIF  files  in  a  PC  is  given  in  Appendix  D.  Kermit 
file  transfers  between  a  PC  and  a  DMINS  are  covered  in  Appendices  E  through  0. 

2.2.2  Zenith  248  Personal  Computer  Hardware  and  Software. 

The  microcomputers  we  usually  use  to  send  DIF  files  to  the  DTIC  DMINS  are 
Zer.ith  248  Personal  Computers.  Each  Includes  a  keyboard,  monitor,  one  5-1/4 
disk  drive  (the  A  drive)  ,  one  20-megabyte  hard  disk  drive  (the  C  drive) ,  and 
an  ALPS  P2000Q  printer. 

Although  the  procedure  for  connecting  a  Zenith  248  to  the  DMINS  is  simple, 
well  documented,  and  widely  known,  section  E.l  of  Appendix  E  describes  it. 

The  operating  system  used  in  the  Zenith  248  is  MS-DOS  Version  3.20.  The 
ZSTEMpc  communications  program  is  used  to  emulate  a  VT100  terminal  when  the 
Zenith  talks  with  the  DMINS.  ZSTEMSpc  is  a  graphics  version  of  ZSTEMpc.  We 
will  refer  to  these  programs  generloally  as  ‘ZSTEM.-'  PC  diskettes  containing 
DIF  files  produced  by  LEF-to-DIF  conversions  are  taken  to  one  of  the  Zenith 
248s,  put  in  the  A  drive,  perhaps  copied  to  a  C  drive  directory,  and  uploaded 
to  the  DMINS.  The  Kermit  file  transfer  protocol  is  used.  It  is  embodied  in 
the  Unix  and  ZSTEM  Kermit  processors.  The  Crosstalk  XVI  Kermit  processor  can 
also  be  used,  but  ZSTEM’ s  is  much  faster,  since  it  uses  a  9000-baud 
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communication  line,  while  In  our  ayatew  Croaatalk  can  uaa  only  alowor  linoa. 

Appendix  I  deacribea  the  ZSTEM  procedurea  for  file  tranafera  between  a  Zenith 
248  PC  and  a  DLA  DMIIS  coaputer.  Appendix  P  deacribea  the  Croeatalk 
procedurea  for  auch  file  tranafera.  Appendix  Q  deaoribea  the  Kermit  file 
tranafer  protocol . 

2.3  Defenae  Loglatica  Agency  (DLA)  Diatributed  Minicomputer  Syatew  (DMIIS) 
Hardware  and  Software 

We  briefly  treat  the  DLA  DMIIS  hardware  and  aoftware  in  aectlona  2.3.1  and 
2.3.2,  reapectlvely. 

2.3.1  DLA  DMIIS  Hardware. 

Each  DLA  DMIIS  la  boated  by  a  Oould  0050  winioowputer  and  contalna  varloua 
atorage,  printing  and  communicationa  devicea.  Theae  Include  not  only  the 
Zenith  PCa  covered  in  aection  2.2.2,  but  alao  Tiaual  VT- 102  ‘duab’  terwinala 
and  their  printera. 

The  DTIC  and  aowe  other  DLA  DMIIS  cowputera  are  connected  to  a  Bell  Atlantic 
Central  Office  baaed  Local  Area  letwork  (C.O.  LAI  or  CO-LAI),  which  allowa 
cuatoaera  to  ahare  information  and  reaouroea  by  connecting  terwinala, 
workatationa  and  cowputera.  The  C.O.  LAI  haa  gateway  connectlona  to  the 
Direct  Diatance  Dialing  network  and  to  Bell  Atlantic  or  other  Public  Packet 
Switched  letworka.  Thua  a  DTIC  DMIIS  uaer  can  remotely  uae,  or  Bend  electronic 
wall  to,  or  receive  it  from,  another  DMIIS  in  the  growing  widely-diatrlbuted 
network  of  DMIIS  nodea. 

2.3.2  DLA  DMIIS  Software. 

The  operating  ayatew  in  the  DLA  DMIIS  la  UTX/32,  which  la  a  port  of  Berkeley 
Unix  4.2.  In  thia  report  we  will  refer  to  the  DMIIS  operating  ayatew  by  the 
generic  name  Unix. 

The  DLA  DMIIS  provldea  the  following  aoftware  relevant  to  our  application:  a 
Unix  Kermit  file  tranafer  proceaaor  and  the  Quadratron  Q-Offlce  office 
automation  package,  including  the  Q-One  word  proceaaor.  In  thia  report  we 
generally  aaeume  that  the  reader  haa  learned  Q-Office  aoftware  from  couraea 
and  manual a ,  and  cover  only  featurea  cloaely  related  to  the 
converaion/tranafer  proceaa. 
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Q-Office  ia  reached  through  tha  DMIVS  we ’ n  ksu,  which  looks  lika  this: 

DEFUSE  LOGISTICS  AGE  VC  7 
DATA  SYSTEMS  AUTOMAT I OV  CE1TEB 


1  Change  Tour  Password 

2  Q-Office  (Word  Proc  /  Mail) 

3  Data  Basa 

4  Elactronic  Mall  Forwarding 

5  Bus inass  Graphics 

6  20/20  Spraadshaat 

7  Lock  this  Taralnal 

8  Phonabook 

0  Bourn#  Shall 

10  C  Shall 

11  CAI  Coursaa 

12  IVFO 


Entar  option  or  ’x’  to  logout 

If  you  pick  option  2,  you  got  tha  Q-Offica  wain  aanu.  If  you  pick  option  10, 
you  gat  tha  Unix  C  Shall  and  its  prowpt  (X),  and  can  antar  C  shall  commands. 
Whan  finishad  with  C  Shall,  type: 

CTRL/D  Ba turn 

to  raturn  to  tha  DMIVS  wain  wanu. 

Saction  E.l  of  Appandix  E  tails  how  to  start  a  Zanith  248  PC  and  connact  to 
tha  DMIVS.  If  you  than  you  corractly  log  into  tha  DMIVS  and  antar  your 
password,  you  gat  tha  DMIVS  wain  wanu. 

2.4  Location  of  Hardwara  and  Software  Usad 

Tha  location  of  the  Lanlar/Sparry  PC  subsystem  is  somewhat  arbitrary  but  seams 
to  work  fine.  It  is  due  to  proximity,  generosity  and  cooperation. 

Tha  Lanier  and  tha  Sparry  PC  are  in  a  room  with  other  word  processing 
equipment.  This  room  is  near  tha  communicating  Lanier  owner’s  office,  so  that 
the  owner  could  conveniently  use  it  during  pre-transfer  days  and  non-transfer 
times.  LIF-to-LEF  processes  have  top  priority.  LEF-to-DJF  format  conversions 
can  ba  dona  in  tha  Sparry  in  this  room.  But,  since  tha  room  has  no  telephone 
line  for  connecting  with  a  DMIVS,  DIF  file  transfers  to  DMIVS  and  DIF 
conversions  to  Q-One  documents  must  ba  dona  from  elsewhere,  preferably  using  a 
Zenith  248  connected  at  0800  baud  to  the  DMIVS.  DIF-to-QIF  conversions  can 
also  ba  dona  using  a  VT-102  'dumb'  terminal. 

Tha  locations  of  tha  various  DLA  DMIVS  are  beyond  tha  scope  of  this  report. 


DATA  FORMATS 


The  data  involved  in  the  Lanier-to-DMINS  conversi on/transf er  process  is  stored 
in  -four  -formats:  Lanier  internal  format,  Lanier  external  format,  Document 
Interchange  Format,  and  Q-One  internal  format.  These  terms  were  introduced  in 
the  overview  in  section  1.2  above.  Document  Interchange  Format  is  a  standard 
format.  The  names  of  the  other  three  formats  were  fabricated  for  this  report. 
This  chapter  consists  of  four  sections,  each  describing  one  of  the  four 
formats. 

3.1  Lanier  Internal  Format  (LIF) 

Full  information  on  how  the  Lanier  represents  text  internally,  that  is,  in  its 
working  memory  and  on  disk,  was  not  available  and  was  not  needed.  A  helpful 
reference  was  the  "No  Problem  Transmit  Table  Quick  Reference  Chart"  on  page 
5.17  of  the  Lanier  document  LTE-3  IIV-ASCII  lables,  of  which  we  were  able  to 
obtain  only  a  few  pages.  This  chart  helped  us  build  a  TTY-ASCII  communication 
table  file  suitable  for  our  application. 

Lanier  internal  format  (LIF)  uses  an  eight-bit  code.  The  Quick  Reference 
Chart  is  a  16  by  16  table.  Rows  and  columns  are  numbered  0  through  15.  The 
first  half  of  the  chart  shows  key  presses  in  the  cells  in  rows  0  and  1  and 
ASCII  characters  in  those  in  rows  2  through  7.  For  example,  cells  0  through  6 
represent  presses  of  the  FRMT,  FILE,  SCRN,  EXEC,  CNCL,  DEL  CHAR  and  INS  keys, 
while  the  corresponding  cells  in  row  1  represent  presses  of  the  same  keys 
while  CTRL  is  pressed. 

Special  keyins  are  required  to  produce  certain  LIF  items.  Some  LIF  items  seem 
not  to  be  single  characters.  For  example,  start  boldface  is  keyed  in  as 
QIRL/X  +  b.  If  this  sequence  is  saved  in  a  file,  and  the  file  is  transmitted, 
start  boldface  is  sent  as  the  f our-character  sequence:  ESC  BS  _  b.  Thus  it 
seems  likely  that  the  LIF  item  is  not  a  single  character. 

3.2  Lanier  External  Format  (LEF) 

The  format  of  text  communicated  from  the  Lanier  depends  on  the  LIF,  the 
workings  of  the  TTY-ASCII  program,  and  the  TTY-ASCII  transmit  table  used. 

(The  TTY-ASCII  program  and  transmit  tables  were  described  in  section  2.1.2 
above. )  For  example,  since  the  Lanier  sends  a  carriage  return  character  (CD) 
at  the  end  of  each  line  which  does  no':  end  with  a  hard  return,  our  transmit 
table  changes  a  hard  return  into  a  GS  (group  separator)  character  (ID)  to  make 
lines  which  end  in  a  hard  return  distinguishable  from  those  which  do  not.  (A 
hard  return  is  entered  by  pressing  RETURN.) 

Another  example  is  the  BS  (backspace)  character  (08).  Lanier  saved  pages 
contain  BS  characters  in  control  sequences.  The  Lamer  ordinarily  sends  tech 
underlined  character  as  a  3-character  sequence:  the  character  followed  by  a  BS 
followed  by  an  underline  character.  The  BS  causes  some  receivers  to  drop  the 
previous  character,  so  that  only  the  underline  character  is  saved.  To  solve 
this  problem,  we  have  the  Lanier  send  a  US  (unit  separator)  character  (IF) 
instead  of  a  BS.  We  arrange  this  by  putting  IF  in  the  BS  (08)  cell  in  the 
transmit  table.  LIF-to-LEF  conversions  are  covered  in  section  5.1  below. 

In  the  receiving  PC,  the  LEF  file  is  a  standard  MS-DOS  text  file,  although 
some  control  character  symbols  (see  Appendix  A)  may  be  unfamiliar  to  some. 
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3.3  Document  Interchange  Format  (DIF) 

The  Document  Interchange  Format  (DIF)  is  a  representation  (encoding)  of 
control  information  used  in  formatting  documents.  It  was  developed  by  the 
Institute  for  Computer  Sciences  and  Technology  at  the  National  Bureau  of 
Standards,  at  the  request  of  the  Department  of  the  Navy.  It  is  sometimes 
called  "Navy  DIF"  to  distinguish  it  from  other  formats  called  "DIF."  We  will 
just  call  it  “DIF."  Its  purpose  is  to  facilitate  document  interchange  among 
text  processing  systems  of  different  vendors. 

In  a  text  processing  system,  a  document  is  composed  of  printed  characters  and 
control  information  used  to  format  the  document.  When  a  document  is  sent  from 
one  text  processing  system  to  another,  the  control  information  must  be 
correctly  interpreted  by  the  receiving  system.  The  DIF,  which  is  defined  in 
reference  2,  is  a  representation  of  document-f ormatting  control  functions.  It 
was  based  on  existing  standards  and  uses  standard  code  extension  techniques. 

Section  3.3.1  describes  the  DIF.  Section  3.3.2  covers  correspondences  between 
LEF  and  DIF  functions. 

3.3.1  Description  of  the  Document  Interchange  Format 

The  basic  code  table  for  7-bit  ASCII  may  be  represented  as  a  matrix  consisting 
of  eight  columns  and  sixteen  rows  (see  Appendix  A).  Columns  0  and  1  contain 
the  control  (non-printing)  characters,  which  are  called  the  CO  set.  Columns  2 
through  7  contain  human  readable  (printing)  characters,  which  are  called  the 
GO  (graphic)  set.  Since  text  processing  systems  do  not  always  agree  regarding 
the  CO  set  functions,  the  DIF  uses  only  two  CO  characters:  Horizontal  Tab  (09) 
and  Escape  (IB),  abbreviated  HT  and  ESC. 

The  DIF  contains  43  functions: 

1  CO  character  (HT) 

13  previously  standardized  functions 
29  new  functions 

The  DIF  uses  a  Control  Sequence  Introducer  (CSI)  to  expand  the  control 
functions  as  defined  by  the  CO  set.  The  general  format  of  a  DIF  control 
sequence  is  as  follows: 

CSI  P...P  I...I  F 


where 


CSI  is  the  two-character  sequence  ESC  C 

P...P  are  0  or  more  parameters  composed  of  decimal  digits  and 
sometimes  separated  from  each  other  by  the  character  ; 

I... I  are  intermediate  characters  used  to  expand  the  set  of 
functions  defined  by  F 

F  is  a  function-defining  character  taken  from  the  set  SP  through 

'  (20  through  7E) . 
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For  example,  the  control  sequence 


BSC  [  7  2  *  A  (IB  5B  31  32  24  41) 

is  a  right  margin  set  function,  in  which  72  is  a  parameter,  *  is  an 
Intermediate  character  and  A  specifies  the  function. 

Only  four  DIF  functions  do  not  start  with  the  CSI: 

HT  horizontal  tab 

BSC  E  hard  new  line 

ESC  X  subscript  on  (superscript  off) 

ESC  L  subscript  off  (superscript  on) 


3.3.2  Correspondences  between  LBF  and  DIF  Functions 

All  LBF  functions,  except  stop  printing,  are  convertible  to  DIF.  The  LEF 
functions  are  underscore,  emphasis,  overstrike,  subscript,  superscript,  hard 
space,  hard  return,  and  justification.  Justification  means  inserting  just 
enough  spacing  in  each  line  to  put  the  last  character  at  the  right  margin. 

This  is  done  by  loading  a  special  program  from  a  special  Lanier  disk  and 
applying  the  following  commands  to  each  page  where  justification  is  desired: 

SCBI  ♦  J  ♦  L  ♦  EXEC 

SCRI  +  J  +  P  +  EXEC 

icii  ♦  j  ♦  b  ♦  life 

where  J  stands  for  Justify,  L  stands  for  line,  P  for  paragraph  and  B  for 

remainder.  The  result  is  that  one  of  a  set  of  a  special  character  sequences 
is  inserted  in  the  left  margin  of  each  line  to  be  justified.  Justification 
takes  place  only  when  a  page  is  printed.  Similarly,  justification  is  removed 
by  the  following  commands: 

SCSI  ♦  J  ♦  E  ♦  L  ♦  EXEC 

SCRI  ♦  J  ♦  E  ♦  P  ♦  EXEC 

sell  ♦  j  +  e  ♦  r  ♦  Ix|c 

where  E  stands  for  erase. 

Conversion  to  Q-One  of  justified  lines  in  a  Lanier  text  can  be  done  by  erasing 
justification  from  each  Lanier  page  before  sending  the  text  to  the  PC,  and 
restoring  justification  after  the  text  is  converted  to  a  Q-One  document.  This 
is  done  by  setting  to  the  letter  *y'  the  justification  parameter  in  the  format 
style  section  of  Q-One’s  extended  format  menu.  Justification  is  done  when  the 
document  is  printed.  Removal  of  justification  indicators  from  a  Lanier  text 
might  be  handled  by  a  special  program  to  remove  justification  from  a  LEF  text 
before  converting  it  to  DIF.  We  recommend  that  justification  be  removed  by 
the  Lanier  commands  listed  above. 

Some  DIF  functions  are  not  found  in  LBF.  Some  of  these  could  be  added  to  DIF 
files  before  they  are  converted  to  QIF.  Examples  are: 

Document  Start 

Pitch  (10  or  12  characters  per  inch) 
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Margin*  (top,  loft,  right,  bottom) 

Hard  Pag*  Start 

Pag*  Length  and  Pag*  Width 

Pag*  lumbering  Initial  Value 

An  initial  DIP  function  sequence  ia  put  in  *ach  DIF  fil*  by  th*  LEP-to-DIF 

converter  (see  **ction  5.2  below).  Th*  u**r  must  a*l*ct  a  aubaot  of  initial 

DIF  function*,  including  pag*  width  and  l*ngth,  margins,  and  horizontal  and 

vertical  apacing.  Th*a*  way  b*  a*l*ct*d  individually  or  by  picking  th* 
identifier  of  a  pr***t  aubaot.  Setting*  ap*cifi*d  by  an  initial  DIF  a*qu*nc* 
can  b*  changed  by  Q-On*  commands  after  DIP-to-QIF  conversion.  (S**  section 
D.l  of  Appendix  D.) 

3.4  Q-On*  Internal  Format  (OIF). 

Q-One  internal  foraat  (OIF)  ia  th*  format  in  which  th*  DMIMS  word  proceaaor  Q- 
On*  atorea  a  document  after  aomeone  has  uaed  Q-One  to  create  a  new  document  or 
modify  an  old  on*.  A  knowledge  of  thla  format  la  not  required  for  Lanier-to- 
DMIVS  convora ion/ transfer a.  Conversion  of  documents  from  DIF-to-QIF  ia 
covered  in  section  5.3  below. 


4.  DATA  T&ANSFEBS 


Thia  chapter  describes  tha  data  tranafar  atapa  in  our  application.  Theaa  were 
introduced  in  aaction  1.2  above.  Section  4.1  covara  Laniar-to-PC  data 
tranafara.  Section  4.2  covara  PC  to  DMINS  data  tranaf era. 

4.1  Lanier  to  Paraonal  Computer  Data  Tranafara 

At  tha  outaat,  let 'a  not  forget  some  very  important  atapa  preliminary  to 
converaion/tranafar  procaaa  itself,  namely  going  through  tha  Lanier  dlaka, 
analyzing  their  contents,  selecting  documents  to  ba  transferred,  and  making 
sure  that  they  are  separate  and  that  thair  pages  are  connected  correctly  (see 
sections  2. 1.2.2  and  8.1  in  Appendix  B) .  In  some  cases  it  may  be  easier  to  do 
a  little  document  content  cleanup  now  than  after  conversion  to  a  Q-One 
document . 

A  Lanier-to-PC  data  transfer  is  done  by  two  communications  program:  TTY-ASCII 
in  the  Lanier  and  Crosstalk  XVI  in  tha  PC  (see  Chapter  2  above) .  The  operator 
activates  a  receiving  function  in  the  PC  and  then  activates  a  sending  function 
in  the  Lanier.  The  Lanier  reads  text  from  a  disk  in  its  upper  drive,  sends  it 
through  the  connecting  null  modem  cable  to  the  PC,  which  writes  it  to  a  disk 
file  in  its  B  drive.  (A  procedure  for  such  a  transfer  is  described  in 
Appendices  B  and  C.) 

Sender  and  receiver  are  set  for  2400-baud  transmission  speed.  The  LEF  file 
produced  in  the  PC  is  a  standard  MS-DOS  text  file  (containing  LEF  sequences). 
When  one  is  displayed,  some  control  character  symbols  (see  Appendix  A)  may  be 
unfamiliar  to  some. 

4.2  Personal  Computer  to  DMIMS  Data  Transfers 

For  PC-to-DMINS  data  transfers  the  Kermit  file  transfer  protocol  is  used. 

This  is  embodied  in  the  PC  in  the  Xermit  functions  of  the  ZSTEM  and  Crosstalk 
communications  programs,  and  in  the  DMINS  in  the  Unix  Xermit  processor.  You 
can  view  the  online  manual  for  the  Dnix  Xermit  processor  by  typing: 

man  kermit  Retrn 

when  you  have  the  Unix  prompt,  but  this  is  unnecessary. 

The  procedure  for  a  PC-to-DMINS  file  transfer  may  be  summarized  as  follows: 

1.  Use  ZSTEM  or  Crosstalk  to  connect  to  the  DMIMS  and  log  in. 

2.  Get  the  DMINS  main  menu. 

3.  Select  the  C  Shell  option  (item  10)  and  get  the  Unix  prompt  (X). 

4.  Enter  a  Unix  Kermit  receive  command. 

5.  Get  the  PC  command  prompt. 

8.  Enter  one  or  more  Kermit  send  commands,  each  naming  a  file  or  set 
of  files  to  be  sent. 

7.  When  all  files  have  been  sent  return  to  the  DMINS  main  menu. 

The  PC  Xermit  processor  shows  status  information  while  the  transfer  proceeds. 

In  the  Kermit  protocol,  control  information  and  data  is  sent  in  packets 
composed  of  7-bit  ASCII  characters.  Each  packet  includes  a  sequence  number 
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and  a  checkaua  of  ona  or  aora  charactera.  Acknowledge  (ACK)  and  negative 
acknoirladga  (VAX)  packata  ara  uaad .  If  a  aant  packat  is  not  acknowledged,  it 
ia  aant  again.  A  aingla  Karait  coaaand  can  aand  aany  filaa,  and  tranaaiaalon 
could  go  on  for  houra  without  operator  intarvantion. 

Procaduraa  for  doing  a  Karait  file  tranafar  between  a  PC  and  a  DM1NS  computer 
ara  daacrlbad  in  Appandicaa  K  and  7.  The  Karait  protocol  itaalf  ia  daacribad 
in  Appendix  Q. 


S.  DATA  FORMAT  CONVERSIONS 


This  chapter  describee  the  three  kinds  of  data  format  conversion  done  in  our 
Lanier-to-DMINS  conversion/transf er  effort.  Section  5.1  covers  LIF-to-LEF 
conversion.  Section  5.2  covers  LBF-to-DIF  conversion.  Section  5.3  covers 
DIF-to-QIF  conversion. 

5.1  Lanier  Internal  to  Lanier  External  Format  Conversion 

Section  5.1.1  covers  transmit  table  modifications.  Section  5.1.2  covers  each 
function  whose  LBF  representation  is  a  sequence  of  characters.  Section  5.1.3 
summarizes  the  transmit  table's  effect. 

5.1.1  Lanier  Transmit  Table  Modifications 


The  following  table 

shows 

transmit 

table  modifications 

peculiar  to  our 

application  (see  section 

2.1.2 

.3) : 

Keyin 

Cell 

LEF 

ASCII 

Use 

08 

IF 

US 

unit  separator 

stands  for 

backspace 

OD 

ID 

as 

group  separator 

hard  return 

CTRL/® 

9C 

5C 

\ 

backward  slash 

typing  to  receiver 

SHI FT/ 8 

9D 

5E 

* 

caret 

typing  to  receiver 

CTRL/O 

9E 

OE 

SO 

shift  out 

overstruck  0 

CTRL/u 

9F 

15 

NAX 

negative  acknowledge  typing  to  receiver 

CTRL/p 

CO 

08 

BS 

backspace 

typing  to  receiver 

CTRL/5 

C3 

7D 

) 

right  curly  brace 

CTRL/3 

C4 

7B 

( 

left  curly  brace 

CTRL/2 

C5 

7E 

tilde 

CTRL/X 

E3 

IB 

ESC 

escape 

control  function 

sequence  starter 

CTRL/SPACE 

EA 

IE 

RS 

record  separator 

hard  space 

The  Keyln  column  tells  how  an  Instance  of  the  cell  identifier  gets  into  a  LIF 
text  or  into  a  message  typed  to  the  receiver,  depending  on  whether  the  current 
function  is  editing  or  communicating.  The  LEF  column  shows  the  value  in  the 
cell . 

We  mapped  the  LIF  backspace  to  the  unit  separator  (08  to  IF)  to  prevent  loss 
of  underlined  characters.  In  LIF  each  underlined  character  is  represented  by 

the  character  followed  by  a  backspace  followed  by  an  underline  character.  If 

the  backspace  is  sent,  some  receivers  drop  the  first  character. 

We  mapped  the  LIF  paragraph  separator  (hard  return) ,  which  is  entered  by 

pressing  RETURN,  to  OS  (0D  to  ID)  to  make  it  distinguishable  from  the  soft 
return  (0D)  sent  at  the  end  of  each  line.  The  receiving  computer  program  may 
or  may  not  put  a  LF  character  after  each  CR  received. 

We  mapped  the  LIF  divide  symbol  to  the  backward  slash  character  (0C  to  50  to 
make  it  possible  to  send  a  backward  slash,  which  is  important  in  Unix.  (The 
divide  symbol  is  not  expected  to  appear  in  the  files  to  be  converted.) 

We  mapped  the  LIF  overstruck  0  to  the  SO  character  (9E  to  OE)  to  make  it 
distinguishable . 
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We  mapped  CTRL/T  and  CTRL/U  to  NAK  (9F  to  15)  to  make  it  possible  to  send  a 
NAK,  which  some  systems  interpret  as  erase  line. 

We  mapped  the  paragraph  symbol  to  backspace  (CO  to  08)  to  make  it  possible  to 
send  a  backspace  while  08  is  mapped  to  IF. 

We  mapped  an  unknown  character  to  tilde  (C5  to  7E)  to  make  it  possible  to  send 
tildes. 

We  mapped  CTRL/W  to  ESC  (E3  to  IB).  This  character  starts  certain  control 
sequences  described  below.  It  sometimes  results  -from  typing  CTRL/X,  for 
example  in  typing  start  of  boldface. 

We  mapped  hard  space  to  record  separator  (EA  to  IE)  to  make  it  distinguishable 
from  an  ordinary  space. 

The  significance  of  some  mappings  in  transmit  tables  received  from  Lanier 
representati ves  were  not  understood. 

5.1.2  Functions  Whose  LEF  Representations  Are  Sequences  of  Characters. 

The  LEF  representation  for  the  following  functions  is  a  sequence  of 
characters:  boldface,  underlining,  overstrike,  subscript,  superscript,  and 
stop  printing,  which  is  not  a  DIF  function. 

BOLDFACE  (emphasis'  is  represented  in  LEF  by  a  start  bold  and  a  stop  bold 
sequence.  These  are  typed  as  CTRL/X  +  b  and  CRTL/X  +  e,  and  are  sent  as: 

ESC  US  _  b  and  ESC  US  _  e 

IB  IF  5F  62  IB  IF  5F  65 

Each  character  between  these  two  sequences  is  emphasized. 

UNDERLINING  is  represented  in  LEF  by  sending  a  backspace  and  an  underline 
character  after  each  character  to  be  underlined.  For  example,  "It  is  so1"  is 
sent  as: 


1  t  SP  l  US  _  s  US  SP  s  o 

49  74  20  69  IF  5F  73  IF  5F  20  73  6F  2E 

In  Lanier  editing,  to  start  or  stop  automatic  underlining  type  SCRN  +  -. 

OVERSTRIKE  is  represented  in  LEF  by  an  ESC  followed  by  the  overstriking 
character.  For  example,  A  overstruck  by  is  typed  as  A  +  CTRL/x  +  W  +  and 
sent  as: 

A  ESC  ^  (5E  IB  7E) 

SUBSCRIPT  is  represented  in  LEF  by  putting  the  sequence  "ESC  US  _  z"  before 
each  character  to  be  subscripted.  It  is  typed  as  CRTL/x  +  z.  For  example: 

2  3  ESC  US  z  1  ESC  US  _  z  6 

32  33  IB  IF  5F  7A  31  IB  IF  5F  7A  36 

is  sent  for  23  (23  base  16). 

16 
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SUPERSCRIPT  is  represented  in  LEF  by  putting  the  sequence  'ESC  US  _  y ' 
before  each  charactar  to  ba  auparacriptad.  It  ia  typad  aa  CRTL/x  +  y.  For 

example: 

a  ESC  US  _  y  1  ESC  US  _  y  0  SP  ♦  SP  b 

81  IB  IF  5F  79  31  IB  IF  5F  79  32  20  2B  20  62 

10 

ia  aant  for  a  ♦  b. 

STOP  PBIVTIVQ  ia  rapraaantad  in  LEF  by  tha  aaquanca  'ESC  US  _  a'.  This  ia 

typad  a a  CTRL/X  +  a.  Tha  function  ia  not  in  tha  DIF.  Tha  LEFDIF  convartar 
puta  'LAMliiTsTOP  PRIHTIIG  CODE  WAS  HERE'  in  ita  place  in  tha  DIF  file. 

5.1.3  Summary  of  Tranamit  Table  Effecta. 

The  tranamit  table  ha a  the  following  effects: 

1.  All  the  ASCII  graphic  charactera  except  DEL  (20  through  7E)  can  be 
aent.  (But  the  Lanier  aenda  a  DEL  after  each  page.) 

2.  The  aendable  control  charactera  and  their  meaninga  are: 


Key  in 

Character 

Meaning 

CTRL/p 

06 

BS 

backspace 

0D 

CR 

soft  return 

CTRL/0 

0E 

SO 

overstruck  0 

CTBL/u 

15 

MAX 

cancel  line 

CTRL/x 

IB 

ESC 

control  function  sequence  starter 

RETURM 

ID 

QS 

hard  return 

CTRL/ SPACE 

IE 

RS 

hard  space 

IF 

US 

backspace  in  a  control  sequence 

3.  Only  105  of  the  126  ASCII  character  are  aendable.  The  23  not 
aendable  are:  00-07,  09,  0B,  0C,  OF,  10-14,  18-1A,  and  7F.  But  the  Lanier 
automatically  aenda  a  7F  (DEL)  after  each  page. 

4.  The  control  functlona  boldface,  underline,  overatrike,  aubacript, 
auperacript,  and  atop  printing  are  aequencea  composed  of  ESC,  US,  underscore 
and  graphic  charactera. 

The  MS-DOS  operating  system  in  the  receiving  PC  puts  a  SUB  (IA)  character  at 
the  end  of  each  disk  file  it  closes. 

5.2  Lanier  External  to  Document  Interchange  Format  Conversion 

To  convert  LEF  functions  into  DIF  functions  a  special  computer  program  called 
LEFDIF  was  developed  by  che  author  of  this  report.  The  source  code  file  for 
this  program  not  yet  frozen  and  deliberately  not  provided  in  this  report,  to 
allow  for  improvements  in  its  user  friendliness  and  internal  documentation. 

This  program  requires  at  the  outset  that  the  user  select  values  for  the 
following  parameters:  page  length,  page  width,  left  margin,  right  margin,  top 
margin,  bottom  margin,  vertical  spacing  (lines  per  inch)  and  horizontal 
spacing  (charactera  per  inch).  These  are  explained  in  Appendix  D,  which 
describes  the  LEF-to-DIF  conversion  procedure. 
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LKFDIF  than  p assea  twice  through  the  input  LSF  flit  and  output*  a  DIF  file. 
Paaa  1  chaeka  tha  laft  margin  of  aach  lina  and  pauaaa  if  it  la  samller  than 
apaclflad.  Thia  permits  tha  uaar  to  atop  LKFDIF  and  claan  up  tha  LEF  fila  if 
daalrad  (raraly) .  For  example,  sometimes  during  tha  LIF-to-LKF  atap 
character*  typad  at  tha  Lanlar  gat  into  tha  LEF  fila  at  tha  atart  of  a  paga, 
raking  tha  laft  margin  1. 

Paaa  2  lnaarta  an  initial  DIF  function  sequence  at  tha  atart  of  tha  output 
fila.  Thia  aaquanca  includaa  tha  valuaa  apacifiad  by  tha  uaar  in  Paaa  1.  The 
program  la  written  in  tha  Microsoft  C  programming  language  and  run*  under  MS- 
DOS  in  an  IBM  or  Sparry  or  Zenith  248  PC.  (Tha  procedure  la  daacribed  in 
Appendix  D) . 

Following  *r~  DIF  functions  corraaponding  to  the  LEF  function*: 


Emphasis  (boldface)  on  and  off  arc: 


ESC 

[ 

1 

m 

ESC 

I 

2 

2 

m 

IB 

SB 

31 

6D 

lb 

.'3 

32 

32 

6D 

Underscore 

(underline)  on  and 

off  ara: 

E?C 

[ 

4 

m 

ESC 

C 

2 

4 

m 

1.4 

53 

34 

6D 

IB 

SB 

32 

34 

6D 

Overstrike 

Oil  a. 

A  off 

are: 

ESC 

( 

0 

m 

BSC 

C 

2 

9 

a 

IB 

5B 

39 

8D 

IB 

5B 

32 

39 

6D 

Subacript  on  and  off,  and  auparscript  on  and  off  are: 

ESC  X  ESC  L  ESC  L  ESC  K 

IB  4B  IB  4C  IB  4C  IB  4B 

Tha  aingle-character  LEF  function*  ara  coded  aa  follow*: 

hard  apace  ESC  [  •  H  (IB  SB  24  48) 

hard  new  line  ESC  E  (IB  45) 

Ovaratruck  0  la  not  a  apodal  caaa  in  DIF  but  la  encoded  ualng  tha  ovaratriko 
on  and  off  control  sequences. 

Justify  on  and  off  ara  not  in  LEF,  but  in  DIF  they  ara: 

ESC  [  2  SP  F  ESC  t  0  SP  F  , 

IB  SB  32  20  46  IB  5B  30  20  46 

A  standard  initial  DIF  function  aaquanca  la  shown  in  Figure  3.  It  was 
produced  by  tha  Q-One  funnction  which  converts  a  Q-Ona  document  to  DIF.  Tha 
function  shown  between  paga  format  and  laft  margin  la  unknown. 

Procedure*  for  converting  LEF  files  to  DIF,  and  for  displaying  DIF  files,  are 
described  in  Appendix  D. 
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DOC  STABT  Pitt  LEMGTH  ■  66  TOP  MABQII  -  7 

ESC  t  1  $  X  ESC  I  6  6  *  L  ESC  t  7  *  B 

BOTTOM  MABGII  «  60  PiOl  WIDTH  -  68  PQ.  IB.  II.  YAL. 

ESC  [  6  0  *  C  BSC  [  8  5  «  M  ESC  [  1  * 

>  1  JUSTIFY  OFF  PITCH  ■  10  LIIB  HEIGHT  ■ 

M  ESC  [  0  SP  F  ESC  [  0  SP  K  ESC  [  0  SP  L 

P4GE  F01M4T  ■  POST.  LEFT  M4BQII  »  11 

ESC  (  4  SP  J  ESC  [  4  SP  F  ESC  t  l  1  «  • 

BIGHT  M4BGII  «  78  LIIE  SPEC I IQ  •  1  TBIT  T4B  SET 

ESC  [  7  8  •  A  ESC  t  0  »  \  ESC  [  9  ;  1 


7;25;33;41;49;57 


;  8  5  ;  7  3  ;  8  1  ;  8  9  ;  0  7  SP 

DECIMAL  TAB  SET 

I  ESC  [0;  1  7  ;  2  5  ;  3  3  ;  4  1 


;49;57;65;73;81 

HABD  PAGE  8TABT 

8  9  ;  9  7  (  G  ESC  [  1  f  J 


Figure  3.  A  Standard  Initial  DIF  Function  Saquanca. 
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5.3  Docuaent  Interchange  to  Q-One  Internal  Foriat  Converaion 

Converalon  of  DIF  filea  to  Q-One  internal  foraat  (QIF)  file*  ia  the  left  atep 
in  our  converaion/tranafer  proceaa.  It  ia  done  by  the  Q-One  word  proceaaor 
and  doea  not  require  a  PC.  A  Tiaual  VT-102  'dumb'  terainal  can  be  uaed  from 
here  on. 

Let’ a  aaauae  that  you  have  connected  to  the  DMINS,  logged  in,  and  gotten  the 
DMI MS  aain  aenu,  which  currently  looka  like  thia: 

DEFENSE  LOGISTICS  AGEVCT 
DATA  SYSTEMS  AUTOMATION  CENTER 


1  Change  Your  Paaaword 

2  Q-Off ice  (Word  Proc  /Mail) 

3  Data  Baae 

4  Electronic  Mail  Forwarding 

5  Buaineaa  Graph ica 

8  20/20  Spreadaheet 

7  Lock  thia  Terainal 

8  Phonebook 

9  Bourne  Shell 

10  C  Shell 

1 1  CAI  Couraea 

12  INFO 


Enter  option  or  ’x'  to  logout 

The  following  procedure  ia  uaed  for  DIF-to-QIF  converaiona. 

1.  Select  Q-Off ice  (option  2)  and  get  'Q-OFFICE  MAIN  MENU.' 

2.  Select  Word  Proceaaing  and  get  ’WORD  PROCESSING  MENU.' 

3.  Select  Superviaory  Functiona  and  get  'SUPERVISORY  FUNCTIONS'  menu. 

4.  Select  Convert  A  File  and  get  'FILE  CONVERSION*  aenu. 

5.  Select  DIF  to  Q1  and  get  and  reapond  to  two  proapta. 

At  the  'DIF  Filenaae'  prompt,  type  the  naae  and  preaa  Return. 

At  the  'New  Q1  Filenaae'  proapt,  type  the  naae  and  preaa  Return . 
The  aeaaagea  'In  Progreaa*  and  'Operation  Coaplete*  appear  In 
aucceaaion,  and  the  'FILE  CONVERSION'  aenu  reappeara.  The 
converted  file  ia  now  a  Q-One  docuaent  file,  like  one  produced  by 
the  Create  New  Docuaent  word  proceaaing  option. 

8.  Preaa  Cancl  twice  to  return  through  the  Superviaory  Functiona 
aenu  to  the  Word  Proceaaing  aenu. 

7.  Select  Edit  Old  Docuaent  to  view  or  aodify  the  new  Q-One  file. 

The  DIF-to-Ql  converaion  in  atep  5  doea  not  put  in  aoft  page  breaka.  You  can 
do  thia  aa  part  of  atep  7  while  viewing  the  docuaent.  Preaa  Command , 
highlight  the  the  Hyphenation  *  Pagination  coaaand,  and  aelect  It  by  preaaing 
Return .  Highlight  your  hyphenation  option  by  preaaing  the  apacebar 
repeatedly,  and  aelect  it  by  preaaing  Return .  Then  aelect  automatic  or 
Interactive  pagination  in  the  aaae  way.  Try  aelecting  none  and  automatic. 
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6.  SUMUfiT  OF  THIS  HEPOBT 


This  report  describes  DTIC’a  procedure  for  converting  documents  produced  by 
its  Lanier  lo  Problem  word  processing  machines  to  Q-One  word  processor 
documents  in  its  Defense  Logistics  Agency  (DLA)  Distributed  Minicomputer 
System  (DMIMS) . 

Two  FILE  TBAESFEBS  are  performed.  In  Transfer  1,  a  document  on  disk  in  the 
Lanier  is  communicated  through  a  null  modem  cable  to  a  Sperry  PC  and  stored  in 
a  file  on  a  disk  in  it.  In  Transfer  2,  a  DIF  file  la  communicated  from  a  PC 
over  telephone  lines  to  the  DMIIS  computer.  The  Crosstalk  XVI  and  ZSTEM 
coamuni cat ions  programs  are  used  in  these  two  transfers,  and  the  Xermit  file 
transfer  protocol  in  used  in  Transfer  2. 

Four  text  DATA  FOBMATS  are  involved  in  the  conversion;  Lanier  Internal  Format 
(LIF) ,  Lanier  External  Format  (LEF) ,  Document  Interchange  Format  (DIF) ,  and  Q- 
One  Internal  Format  (QIF) . 

Three  FOBMAT  COHVEBSIOHS  are  performed.  Conversion  1  (LIF-to-LEF)  is  done 
during  Transfer  1.  Conversion  2  (LEF-to-DIF)  is  done  before  Transfer  2  in  the 
Sperry  PC  or  in  a  Zenith  248  or  other  PC.  The  same  conversion  program  would 
be  used  in  any  case.  Conversion  3  (DIF  -to-QIF)  produces  a  Q-One  document 
file.  This  conversion  is  a  Q-One  function  done  in  the  DMIHS  and  can  be  done 
using  a  suitable  ’dumb'  terminal  or  PC. 

The  two  data  transfers,  the  four  data  formats,  and  the  three  format 
conversions  are  described  in  the  body  of  this  report. 

Procedures  for  the  file  transfers  and  format  conversions  are  described  in  the 
appendices  below. 


APPENDIX  A 


THE  4MEBICAI  STAND ASD  CODE  FOE  INFORMATION  INTERCHANGE  (ASCII) 


The  acronym  ASCII  can  refer  to  a  coded  character  eet  or  to  a  widely  used 
asynchronous  communications  protocol  based  on  that  code.  The  ASCII  character 
set  consists  of  7-bit  coded  characters  (8  bits  including  parity  check  bit) 
used  for  information  Interchange  among  data  processing  systems,  data 
communication  systems,  and  associated  equipment.  The  ASCII  set  consists  of 
control  characters,  graphic  characters  such  as  *  and  ♦  ,  and  alphanumeric 
characters. 

The  basic  code  table  for  7-bit  ASCII  is  defined  by  standard  X.34  of  the 
AMrican  National  Standards  Institute  (ANSI).  This  is  represented  as  a  matrix 
consisting  of  8  columns  and  16  rows  (sea  Figure  4) .  Columns  0  and  1  contain 
the  control  (non-printing)  characters  and  represent  the  CO  (control)  set. 
Columns  2  through  7  contain  human-readable  (printing)  characters  and  represent 
the  GO  (graphic)  set.  A  particular  character  is  specified  by  indicating  the 
column  number  followed  by  a  forward  slash  followed  by  the  row  number.  Thus 
'K'  is  specified  by  4/11.  In  this  report  we  specify  a  character  by  giving 
column  and  row  as  hexadecisml  digits.  Thus  we  specify  "X"  by  4B. 

The  meanings  of  the  abbreviations  used  in  the  ASCII  code  table  are: 


ACX  Acknowledge 
BEL  Bell 
BS  Backspace 
CAN  Cancel 
CB  Carriage  Be turn 
DC1  Device  Control  1 
DC2  Device  Control  2 
DC3  Device  Control  3 
DC4  Device  Control  4 
DEL  Delete 
DLE  Data  Line  Escape 
EM  End  of  Medium 
ENQ  Enquire 

EOT  End  of  Transmission 
ESC  Escape 

ETB  End  of  Transmission  Block 
ETX  End  of  Text 


FF  Form  Feed 

FS  File  Separator 

GS  Group  Separator 

HT  Horizontal  Tab 

LF  Line  Feed 

NAK  Negative  Acknowledge 

NUL  Null 

RS  Record  Separator 
SI  Shift  In 
SO  Shift  Out 
SOH  Start  of  Header 
SP  Space 
STX  Start  of  Text 
SUB  Substitute 
SYN  Synchronous  Idle 
US  Unit  Separator 
VT  Vertical  Tab 


DC1  and  DC3  are  often  used  for  flow  control  and  called  XON  and  XOFF 
(transmitter  on  and  transmitter  off).  DC2  and  DC4  may  be  used  similarly  for  a 
second  device. 
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Figure  4.  Seven-Bit  ASCII  Code  Table  with  Screen 
Symbols  for  Control  Characters 


APPENDIX  B 


INTBODUCTIOI  TO  FILE  TRANSFER  FROM 
A  LAMIEB  MO  PROBLEM  WORD  PROCESSOR  TO  A  PERSONAL  COMPUTES 


This  appendix  describes  a  procedure  for  tending  filea  from  a  Lanier  No  Problea 
word  proceaeor  bo  a  Sperry  or  IBM  Peraonal  Computer  <PC)  or  a  aiailar  PC.  It 
aaauaea  that  a  particular  ayatea  ia  to  be  uaed,  and  that  the  operator  of  the 
ayatea  ia  familiar  with  Lanier  Mo  Problem  word  proceaaing.  Although  the 
aachinea  are  quite  cloae  together,  two  people  can  operate  the  ayatea,  if  they 
are  aynchronited,  and  perhapa  get  the  work  done  aore  quickly. 

Thia  appendix  glvea  background  information  helpful  in  underatanding  the 
procedure.  Appendix  C  givea  a  conciae  step-by-step  deacription  of  the 
procedure  for  the  operator  to  follow  when  performing  it. 

In  the  aaauaed  ayatea,  DTIC’a  coaanjmi eating  Lanier  word  proceaeor  ia  connected 
to  a  Sperry  PC  by  aeana  of  a  null  aodea  cable.  The  Lanier  and  the  PC  each 
have  a  keyboard,  a  CRT  screen ,  and  two  disk  drives.  In  the  Lanier,  a 
communications  program  called  ASCI I -TTY  and  a  communication  table  called 
COIMUNITAB  are  uaed.  In  the  PC,  a  version  of  Microsoft,  Inc.’s  MS-DOS 
operating  ayatea  and  Microatuf,  Inc.'s  Crosstalk  XTI  communications  program 
are  used.  The  information  on  MS-DOS  and  Crosstalk  needed  by  the  operator, 
which  is  relatively  Halted,  ia  given  below. 

Section  B.l  covers  use  of  the  TTY-ASCII  prograa  and  table  COMMUNITAB.  Section 
B.2  covers  relevant  features  of  the  Microsoft  Disk  Operating  System  (MS-DOS). 
Section  B.3  covers  use  of  the  Crosstalk  XVI.  Section  B.4  covers  use  of  a 
transfer  name  table. 

B.l  Use  of  the  Lanier  No  Problea  TTY-ASCII  Data  Coamuni cat ions  Program  and 
Table  COMMUNITAB 

At  the  outset,  let’s  not  forget  some  very  important  steps  preliminary  to 
conversion/tranafer  process  itself,  namely  going  through  the  Lanier  disks, 
analyzing  their  contents,  selecting  documents  to  be  transferred,  and  making 
sure  that  they  are  separate  and  that  their  pages  are  connected  correctly  (see 
section  2. 1 .2.2) . 

DTIC  has  exactly  one  Lanier  word  procesor  equipped  for  comaiunications.  To  use 
it  to  communicate,  two  disks  are  required.  One  contains  the  TTY-ASCII 
program,  and  the  other  contains  a  communication  table  specifying 
characteristics  of  the  coaaunication,  such  as  its  speed  and  certain  character 
translations  (see  section  2.1.2  above). 

Three  special  keys  are  used  in  coamunicating.  These  are  the  top  three  keys  in 
the  function  key  group  on  the  left  of  the  keyboard  .(see  Figure  1  above).  From 
the  top  these  are  the  FUNCTION  (FNC)  ,  COHTOMICATIOM  (CMC)  ,  and  BREAK  (BRK) 
keys.  We  will  refer  to  a  key  by  the  name  printed  on  or  beside  it  and 
underline  the  name. 
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The  TTY- ASCI I  program  recognizee  five  FUNCTION  commands: 


FNC  ♦  L  ♦  table  name  ♦  EXEC 
F|5  ♦  D  ♦  me  " 

FKC  ♦  C  ♦  EXEC 

lie  ♦  o  ♦  ms 

FIC  ♦  E  ♦  EXEC 


Load  a  communication  table 
Diaplay  communication  table 
Qo  into  communication  mode 
do  into  Online  Editor  mode 
End  communicationa  link  and  go 
into  Offline  Editor  mode 


The  firat  command  loada  a  communication  table.  The  aecond  command  diaplaya 
the  communication  table  currently  loaded.  The  third  command  puta  the  Lanier 
in  communicationa  mode.  The  fourth  command  puta  the  Lanier  in  Online  Editor 
mode.  Thla  leta  you  uae  certain  editing  commanda  without  breaking  the 
communicationa  link.  The  fifth  command  puta  the  Lanier  in  Offline  Editor 
mode,  breaking  the  comawnicatlon  link  in  aome  caaea  (not  oura) .  To  return  to 
communicationa  mode  execute  the  C  function  command. 


You  load  the  TTY-ASCII  program  from  a  diak  Just  like  a  word  proceaaing 
program.  Insert  the  diak  in  the  upper  drive.  INSERT  here  manna  put  it  in  the 
drive  and  cloae  the  door.  If  the  Lanier  is  off,  turn  it  on.  If  it  ia  already 
on,  push  the  red  load  (boot)  button.  The  drive  light  mill  go  on  and  off 
twice.  lext  remove  the  TTY-ASCII  diak  and  inaert  in  the  upper  drive  the 
communication  table  disk  marked  LCTASLE  at  the  top  of  its  right-hand  label. 

The  drive  light  goes  on  and  off  once  (as  the  disk’s  index  la  read).  If  this 
does  not  happen,  remove  it  and  repeat  the  insertion  until  it  does.  From 
LCTABLE  load  COMMUIITAB  by  typing: 

FIC  ♦  L  ♦  COMMUIITAB  *  EXEC 

Then  set  the  page  width  by  typing: 

FIC  ♦  E  ♦  EXEC 
FRMT  ♦  H  +“144  ♦  EXEC 
FIC  ♦  C  ♦  EXEC 

where  H  stands  for  horixontal.  The  format  command  SETS  THE  PAGE  WIDTH  TO  144. 
IT  IS  IMPORT AIT  THAT  THE  LAIIER  PAGE  WIDTH  SETTING  BE  LARGE  ENOUGH ,  SINCE  IF 
IT  IS  TOO  SMALL,  LINES  MAY  BE  TRUNCATED  WHEN  TRANSMITTED.  The  last  command 
puta  the  Lanier  in  communicationa  mode. 

Now  the  Lanier  ia  ready  to  send  data.  Each  send  command  specifies  a  DATA 
UNIT,  which  here  means  a  page,  a  text  or  a  whole  disk.  (In  our  Lanier-to-PC 
step  whole  diak  commands  are  not  normally  used.)  A  PAGE  ia  produced  by 
copying  to  diak  the  content  of  the  Lanier’s  screen  memory.  A  TEXT  is  a 
sequence  of  connected  pages.  A  TEXT  can  be  built  by  typing  and  memorizing  two 
or  more  pages,  giving  no  page  name  in  the  second  and  subsequent  memorize 
commands  (see  section  2. 1.2.2  above).  To  show  the  names  of  the  items  on  a 
disk  type: 

FNC  ♦  E  ♦  EXEC 
FILE  ♦  I  EXEC 
FRIT  ♦  H  ♦  144  ♦  EXEC 
FIC  ♦  C  ♦  EXEC 

where  I  stands  for  index.  In  the  shown  index  the  names  of  pages  in  a  text 
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appear  on  successive  lino*,  while  each  Ion*  page  and  text  is  separated  from 
tha  next  data  unit  by  a  blank  lina  with  a  faint  dot  at  tha  laft. 

To  atart  landing  a  data  unit  una  ona  of  tha  following  commands: 

CMC  ♦  T  ♦  P  ♦  page_name  ♦  EXEC 

CMC  ♦  T  ♦  T  ♦  taxt  naaa  ♦  EXEC 

cmc  ♦  t  ♦  d  ♦  me 

whara  T  atanda  for  transmit,  P  for  paga,  T  for  taxt,  D  for  diak,  and  pagajname 
and  text.name  for  names  you  pick  (aaa  aaction  2. 1.2.2).  Tha  third  comaund  ia 
raraly  uaad,  alnca  it  puta  all  tha  Laniar  diak’a  taxta  into  one  PC  file,  even 
though  they  way  have  different  characteristica. 

To  atop  transmitting  a  data  unit  in  caae  of  emergency,  type  the  following: 
CTRL/CMCL 

f|c%"c"  ekc 

where  CTRL/CMCL  maana  hold  down  CTRL  and  prana  CMCL. 

A  document  may  axiat  on  a  Laniar  diak  in  two  or  more  aaparate  parta,  each  part 
being  a  paga  or  a  taxt.  It  ia  good  to  connect  tha  parta  in  the  correct  order 
into  a  taxt  before  aanding  tha  document  to  the  PC.  Two  Laniar  COMBINE 
COMMANDS  are  available  for  doing  thia.  Me  will  give  examples  of  their  use, 
showing  Laniar  disk  index  information  in  a  horizontal  format  more  compact  than 
that  of  a  Laniar-producad  index  display. 

Suppose  tha  Laniar  A  drive  disk  contains  Just  five  pages:  AAA,  BBB,  CCC,  DDD 
and  EEE,  and  tha  file  index  is  equivalent  to  this: 

AAA  BBB  CCC  DDD  EEE 

which  shows  that  no  pages  are  connected.  To  form  a  taxt  containing  AAA 
followed  by  BBB,  and  another  containing  DDD  followed  by  EEE,  type: 

FILE  ♦  INS  ♦  P  ♦  BBB  AAA  ♦  |UC 

FILE  ♦  IMS  ♦  P  ♦  EEE  DDD  4  EXEC 

where  P  stands  for  paga.  Note  that  the  ‘following  page'  name  is  typed  before 

tha  'preceding  page'  name,  which  ia  tha  ravaraa  of  their  order  in  the  file 

index  after  the  combine  commands  are  executed.  The  file  index  becomes: 

AAA.BBB  CCC  DDD_EEE 

where  we  put  an  underline  character  between  pages  connected  in  a  text  and  two 
spaces  between  data  units  not  so  connected.  To  .connect  the  two  texts  type: 

FILE  ♦  IMS  ♦  T  *  DDD  BBB  ♦  EXEC 

where  T  stands  for  text.  The  file  index  becomes: 

AAA_BBB_DDD_EEE  CCC 

that  is,  we  now  have  a  four-page  text  and  lone  page.  Suppose  we  next  try  to 
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Insert  page  CCC  after  BBB.  What  happens  to  tha  BBB_DDD  connaction?  Typing; 

FILE  ♦  IMS  ♦  P  ♦  CCC  BBB  4  EMC 
products  ona  taxt  aucb  that  tha  fils  indax  become*: 

AAA_BBB_CCC_DDD_EEE 
If  m  now  typo: 

FILE  4  DEL  CHAB  ♦  P  4  CCC  4  EMC 
tha  flia  indax  becomes: 

AAA-BBB-DDD-EEE 

Pago  CCC  ia  gone,  but  tha  othar  taxt  pagaa  ara  atill  connoctod  in  tha  same 
ordar  aa  bafora. 

Khan  a  Laniar  docuaant  to  ba  transmitted  ia  fragmented,  uaa  tha  combine 
command*  to  connact  tha  part*  into  a  taxt  bafora  sanding  it. 

B . 2  Uaa  of  Microsoft's  Disk  Oparating  Syataa  (MS-DOS) 

Tha  Microsoft  Disk  Oparating  Syataa  (MS-DOS)  ia  uaad  in  tha  PC.  MS-DOS  la  a 
group  of  prograaa  which  (a)  anabla  you  to  organist  and  uaa  tha  information  you 
put  on  disks  and  (b)  control  tha  way  your  coaputar  utaa  othar  prograaa.  Mo 
will  * oaatiaaa  rafar  to  MS-DOS  as  DOS. 

Wa  uaa  tha  MS-DOS  aystoa  disk  aarkod  PCXTALK  at  tha  top  of  its  right-hand 
axtarnal  labol. 


To  load  and  start  MS-DOS,  put  disk  PCXTALK  in  tha  A  (uppar)  driva.  Than,  if 
tha  PC  la  turnad  off,  turn  it  on.  If  it  la  on,  hold  down  Ctrl  and  Alt,  and 
pros*  Dal.  This  is  called  SYSTEM  BESET  and  can  ba  uaad  to  raatart  MS-DOS. 

Mhen  MS-DOS  ia  loaded  and  started,  you  are  prompted  for  the  date  and  tiae.  It 
ia  important  to  wake  them  correct,  since  MS-DOS  saves  the  creation  date  and 
time  of  each  disk  file,  and  this  information  helps  you  identify  your  data. 
Enter  the  date  and  tiae  like  this; 

11-22-87  Betrn 
19:28  Betrn 

that  la,  loveaber  22nd,  1087  at  3:28  p. a. 

After  you  enter  date  and  tiae,  the  following  PBOMPT  appears: 

A> 

where  ’A'  indicates  that  tha  A  drive  is  the  default  driva  and  ’>’  prompts  you 
to  input  a  coaaand.  If  you  give  DOS  a  filename  without  specifying  a  drive, 

DOS  searches  for  the  file  on  the  disk  in  the  DEFAULT  DB1VE.  Another  naaa  for 
the  default  drive  is  the  CUBBEVT  DRIVE.  To  change  the  current  drive  enter  a 
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DRIVE  SPECIFIER,  which  is  a  drive  letter  followed  immediately  by  a  colon: 

8:  Retrn  or  A:  Retrn 

In  PC  commands  we  sbow  an  optional  apace  between  parta  and  before  Retrn. 

We  assume  that  throughout  the  transmission  aeaaion  the  A  drive  la  the  current 
drive  and  containa  diak  PCXTALK. 

A  FILE  ia  a  collection  of  related  Information.  Before  you  can  record  any  file 
on  a  diak,  you  auat  get  DOS  to  format  that  diak.  The  DOS  FORMAT  command 
initialised  a  diak  to  a  recording  format  acceptable  to  DOS,  analyzes  the  disk 
for  defective  tracks,  and  initializes  a  main  directory  on  the  diak.  This  is 
the  disk’s  ROOT  DIRECTORY.  A  DISX  DIRECTORY  is  like  a  table  of  contents.  It 
contains  the  names  of  files  and  other  information  about  the  files.  It  can 
also  contain  the  names  of  other  directories,  which  are  called  SUBDIRECTORIES. 

DOS  can  remember  a  DEFAULT  DIRECTORY  for  each  diak  drive  in  your  system.  This 
ia  called  the  drive's  CURRERT  DIRECTORY.  The  current  drive’s  current 
directory  is  the  DOS  current  directory.  If  you  give  DOS  a  filename  without 
specifying  a  directory,  DOS  searches  for  the  file's  entry  in  current 
directory.  When  DOS  ia  started,  it  will  use  the  root  directory  as  the  current 
directory  of  each  drive.  You  can  change  the  current  directory,  or  find  out 
what  it  is,  by  issuing  the  CHDIR  (Change  Directory)  command. 

An  MS-DOS  FILEMAME  consists  of  one  to  eight  characters  optionally  followed  by 
a  dot  optionally  followed  by  an  EXTEVSIOI  of  up  to  three  characters.  The  name 
SPEECH . TXT  is  an  example.  The  following  characters  can  be  used  in  filenames 
and  extensions: 

a-z  o-d  i  m  1 1  ■  r  (  )  -  (  )  .  " 

Any  other  character,  such  as  a  space  or  a  comma,  terminates  the  filename  or 
extension.  The  GLOBAL  FILEBAME  CHARACTERS  ?  and  •  are  exceptions  to  this. 

The  ?  character  in  a  filename  or  extension  means  that  any  (one)  character  can 
be  in  that  position.  The  *  character  in  a  filename  means  that  any  character 
can  be  in  that  position  and  in  the  rest  of  the  filename.  The  «  character  in 
an  extension  swans  that  any  character  can  be  in  that  position  and  in  the  rest 
of  the  extension. 

A  FILE  SPECIFIER  consists  of  a  drive  specifier  followed  by  a  filename  with 
optional  dot  and  extension.  If  the  file  is  on  the  disk  in  the  current  drive, 
the  drive  specifier  may  be  omitted.  If  the  file  does  not  belong  to  the 
drive’s  current  directory,  the  directory  must  be  specified  immediately  before 
the  filename. 

Each  time  a  Lanier  data  unit  is  to  be  sent,  the  PC  operator  must  name  the  PC 
disk  file  which  will  receive  the  unit.  If  the  name  is  already  in  the 
receiving  disk's  directory  and  you  try  to  send  data,  you  will  be  asked  to  pick 
one  of  these  options:  replace  the  old  file’s  data,  add  the  received  data  to 
it,  or  name  a  different  receiving  f lie. 

Some  DOS  commands  useful  in  our  application  are  FORMAT,  DIRECTORY,  CHDIR, 

COPY,  ERASE,  REEAME,  TYPE  and  MORE. 
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FORMAT  prepare!  a  disk  for  u«e  by  MS-DOS,  destroying  any  data  on  the  disk. 

You  can  specify  a  volume  label  to  be  written  on  the  disk. 

DIRECTORY  (DIR)  shows  a  disk's  volume  label  and  the  name,  size  in  bytes,  and 
creation  date  and  time  of  each  file  represented  the  disk’s  directory.  A  BYTE 
is  eight  bits  and  can  hold  1  character. 

CHDIR  (CD)  changes  the  specified  drive's  current  directory  to  the  one  you 
nates,  if  you  name  one;  otherwise,  it  displays  the  current  directory  path. 

COPY  copies  one  or  more  files  to  the  same  or  another  directory.  If  a  copy  is 
to  be  in  the  same  directory  as  its  original,  it  must  be  given  a  different 

name. 

ERASE  deletes  a  file’s  entry  from  a  disk  directory  and  makes  the  file's  space 
available. 

REMAME  changes  the  name  of  a  file  in  a  disk  directory. 

TYPE  and  MORE  show  the  contents  of  a  text  file  on  a  disk.  For  examples,  *DIR 
B: '  shows  the  B  drive  disk  directory,  and  ‘TYPE  README'  and  ‘MORE  <  README* 
show  the  contents  of  text  file  READ  IS .  MORE  pauses  after  showing  each  screen 
and  TYPE  does  not.  To  tell  MORE  to  show  the  next  screen,  press  the  spacebar. 
To  stop  DIR,  MORE  or  TYPE  before  they  are  finished,  type: 

Ctrl/Break 

A  PC  disk  must  be  formatted  before  MS-DOS  can  write  on  it.  The  FORMAT  COIMA1D 
DESTROYS  AMY  DATA  ON  THE  DISK  IT  FORMATS,  SO  MAKE  SURE  THE  DISK  TO  BE 
FORMATTED  CONTAINS  NO  VALUABLE  DATA,  AND  THAT  ITS  DRIVE  IS  THE  TARGET  DRIVE. 

If  a  disk  is  formatted,  it  will  have  a  main  directory.  If  you  try  to  show  the 
directory  of  an  unformatted  disk,  you  will  be  asked:  'Abort,  Retry  or  Ignore?* 
(answer  A).  Thus  the  DIR  command  helps  determine  if  a  disk  is  formatted.  To 
format  a  disk,  put  it  in  drive  B  and  enter: 

FORMAT/V  B:  Retrn 

Here  ‘/V  specifies  the  volume  label  option  and  'B:'  tells  what  drive  holds 
the  disk  to  be  formatted  (the  target).  When  told  to  ‘insert  new  diskette,'  do 
so,  if  it  is  not  Inserted,  and  press  the  spacebar.  When  FORMAT  is  nearly 
done,  you  are  asked  to  enter  a  VOLUME  LABEL  (up  to  11  characters),  such  as 
ABC_XYZ_123,  which  is  written  on  the  disk.  Enter  one  using  characters 
acceptable  in  file  names,  but  not  dot.  Then  show  the  B  drive  directory  by 
typing: 

• 

DIR  B:  Retrn 

B.3  Use  of  Microstuf’s  Crosstalk  XVI  Communications  Program 

To  use  Crosstalk  XVI,  put  the  disk  marked  PCXTALK  in  the  PC's  A  drive.  If  MS- 
DOS  is  not  running,  load  and  start  it  as  explained  in  section  B.l.  If  the  MS- 
DOS  prompt  is  not  *A>*  type: 


A:  Retrn 


To  start  Crosstalk  typs: 

XTALK  LANIEB  Betrn  or  XL  Betrn 

While  Crosstalk  is  starting,  a  sign-on  msssags  and  a  communications  message 
are  displayed  briefly. 

Crosstalk  shows  just  two  screens:  a  status  screen  and  a  terminal  screen.  If 
you  don't  see  the  screen  you  want,  switch  screens  by  pressing  Rome. 

The  STATUS  SCBEEM  shows  the  names  of  some  commands  which  set  Crosstalk 
options,  and  the  current  setting  of  each.  Since  only  the  first  two  letters  of 
a  command  need  be  entered,  they  are  shown  in  upper  case. 

The  COIWABD  LINE  sometimes  appears  on  the  bottom  line  of  the  screen.  You  can 
get  it  on  the  status  or  terminal  screen  by  pressing  Esc.  You  also  get  it  when 
you  switch  screens.  It  is  in  reverse  video,  with  the  prompt  'Command?'  at  the 
left.  We  will  often  just  say  'Command?*  when  we  mean  the  command  prompt  on 
the  command  line.  To  execute  a  command,  get  Command? ,  type  the  command,  and 
press  Betrn.  If  you  type  a  command  but  decide  not  to  execute  it,  backspace  to 
Command?  and  press  Betrn.  This  removes  the  prompt. 

The  TEBMINAL  SCBEEN  is  useful  when  communicating  with  a  another  computer.  The 
terminal  screen's  bottom  line  is  Its  status  line  when  it  is  not  the  command 
line.  It  shows  capture  and  communications  status.  Capture  is  explained 
below.  In  our  Lanier-to-PC  system  communications  status  is  LOCAL,  meaning 
direct  connection  (no  modem  or  telephone) . 

If  you  see  the  terminal  screen  without  the  command  line,  what  you  type  goes  to 
the  other  computer.  When  the  screen  does  not  show  the  command  line,  Crosstalk 
pays  no  attention  to  what  you  type.  Switching  screens  does  not  disrupt 
communications.  Pressing  End  sends  a  break  signal  to  the  other  computer. 
Crosstalk  calls  gac.  gome  and  fnd  the  ATTENTION,  SWITCH  and  BBEAK  keys, 
respectively.  The  break  key  is  rarely,  if  ever,  used  in  Lamer-to-FC 
transfers. 

If  you  press  Esc,  you  get  Command?  without  changing  screens.  If  you  press 
Home ,  you  get  Command?  and  the  other  screen. 

Any  Crosstalk  command  may  be  entered  any  time  the  command  line  appears.  Use 
upper  or  lower  case  letters.  Type  at  least  the  first  two  letters  of  the 
command  name  followed  by  other  relevant  items,  separating  items  by  spaces,  and 
press  Betrn.  If  the  command  needs  more  information,  you  will  be  asked  for  it. 
A  common  mistake  is  typing  a  command  without  getting  the  command  line. 

The  bottom  10  lines  of  the  status  screen  are  used  as  a  display  window.  The 
terminal  screen's  window,  which  the  CLear  command  can  clear,  has  a  much  larger 
display  window.  Characters  received  from  the  Lanier  are  shown  on  the  terminal 
screen.  Some  commands  which  use  display  windows  are  HElp,  DIr  and  TYpe.  For 
example,  for  help  with  the  DI  command  type: 

HELP  DIBECTOBY  Betrn  or  HE  DI  Betrn 

To  see  the  names  of  all  Crosstalk  cosaands,  type: 

HE  Betrn 
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Before  telling  the  Lanier  to  eend  data,  we  mat  tell  Croaatalk  to  receive  data 
and  where  to  put  it.  For  example: 

CAPTURE  B : UCSPKECH  Betrn 

aaya  'receive  data  and  put  it  in  file  UCSPEECH  to  be  liated  in  the  current  B 
drive  directory.'  To  atop  capturing  data  in  thia  file  type: 

CA  OFF  Betrn . 

You  can  exit  Croaatalk  without  terminating  PC  communications  by  typing: 

XD  Betrn 

which  returna  you  to  MS-DOS,  where  you  can  do  MS-DOS  commands.  To  return  to 
Croaatalk,  type: 

XL  Betrn 

You  can  uae  the  RUn  command  to  exit  Croaatalk  without  terminating 
communications,  execute  an  MS-DOS  command,  and  return  to  Croaatalk,  like  thia: 

BU  RENAME  XXX  TTY  Betrn 

Uae  the  QUit  command  to  terminate  PC  communicationa  and  Croaatalk: 

QU  Betrn 

B. 4  Uae  of  a  Tranafer  Plan 

Wo  atrongly  recommend  that  if  a  person  is  to  do  many  Lanler-to-PC  transferc, 
he  or  she  prepare  a  TRAVSFEB  FLAB  to  be  used  with  each  session.  Thia  may  take 
the  form  of  a  TRANSFER  NAME  TABLE  (TNT) ,  which  has  a  row  for  each  data  unit  to 
be  sent.  Each  row  gives  the  Lanier  disk  name,  unit  name,  and  type  of  unit  to 
be  sent;  the  receiving  PC  disk  name  and  file  name.  For  example: 

LANIEB  WORD  PROCESSOR  PERSONAL  COMPUTES 

DISK  ”  UNIT  TYPE  DISK”'  FILE 

LD-B-001  TABLE-6  PA  51  DTICB-LD003  TABLES 

LD-W-012  BEG3421/5  TEXT  LD-W-BEQ-03  BQ3421-S.LEF 

Here  LD  means  'Lanier  to  DMIIS.'  Write  a  unique  identifier  on  the  external 
label  of  each  Lanier  or  PC  disk  with  a  felt  pen.  No  disk  name  is  included  in 
any  Lanier  sending  or  PC  receiving  command.  Disks  are  rarely  transmitted  as  a 
unit,  since  they  ususally  contain  pages  and  texts  which  have  different 
characteristics  but  all  go  into  one  PC  file. 

Another  way  to  form  a  transfer  plan  is  to  print  each  relevan'  Lanier  disk 
index  on  a  separate  sheet  of  paper,  staple  the  sheets  together,  and  write  in 
the  blank  spaces  appropriate  information,  such  as  PC  file  names  or  margin 
settings,  as  it  becomes  available. 

We  also  recossnend  displaying  the  first  page  of  each  text  to  be  sent,  and 
noting  at  the  top  of  the  screen  the  numbers  of  the  columns  marked  L,  B  and  B, 
and  the  value  of  V.  These  represent  left  margin,  right  margin,  horizontal, 


38 


that  is  maximum  1 in*  length  (page  width) ,  and  page  length. 

The  margin  values  are  important  for  preserving  wraparound  in  the  Q-One 
document  produced  by  step  4  at  the  end  of  the  whole  process  (see  section  1.2 
above) .  It  is  best  if  all  pages  in  a  text  have  exactly  the  same  L  and  R 
values.  If  the  R  values  vary,  use  the  largest  in  step  2  (the  LEFDIF  step). 

It  may  be  worthwhile  to  modify  some  Lanier  pages  before  sending  them. 

The  horizontal  is  important  if  line  truncation  is  to  be  avoided.  The  Lanier 
typist  could  have  used  the  right  arrow  key  to  pass  through  column  R  and  put 
characters  in  the  right  margin.  Such  characters  can  be  truncated  in  a  Lanier- 
to-PC  transfer  if  the  value  of  H  is  too  small.  At  least  this  has  happened 
several  times.  The  transfer  operator  can  manually  set  the  value  of  H,  but 
when  the  Lanier  reads  a  page  for  transfer,  the  H  value  may  become  that  of  the 
P»g«- 

The  PC  receives  and  displays  Lanier  formatting  characters  which  make  their 
lines  appear  longer  than  they  would  if  printed. 

If  you  are  transferring  a  wide  page,  watch  for  truncated  lines  on  the  PC's 
terminal  screen  as  the  incoming  characters  are  displayed.  Note  that  if  a  line 

contains  more  than  80  characters,  the  81st  and  following  Lanier  line 

characters  are  displayed  on  the  next  PC  screen  line,  although  one  Lanier  line 
is  saved  on  disk  as  one  PC  line. 

You  can  get  a  good  idea  of  a  Lanier  page's  margin  settings  by  studying  the 
received  text  lines  (a)  as  displayed  on  the  terminal  screen  or  (b)  as 
displayed  by  the  DOS  MORE  command  after  the  capture  file  is  closed. 

Although  the  Lanier  specifies  margins  as  column  numbers,  Q-One  shows  them  as 

number  of  columns  to  the  left  of  L  or  to  the  right  of  R.  For  example,  if  L  is 

11,  R  is  79  and  H  is  85,  then  each  Q-One  margin  is  10  with  65  columns  between. 

But  if  L  is  13,  R  is  90  and  H  is  102,  then  each  Q-One  margin  is  12  with  78 

columns  between. 

A  Lanier  typist  can  produce  completely  empty  lines  by  using  the  down  arrow  key 

to  pass  through  empty  screen  lines  and  then  typing  text  below  them.  Lines 

with  hard  returns  (paragraph  separators)  at  the  left  margin  should  be  used 
Instead  of  empty  lines.  The  LEFDIF  process  can  omit  empty  lines,  or  replace 
them  with  hard  returns,  or  let  the  transfer  operator  decide  which  to  do. 

The  LEF-to-DIF  process  is  described  in  Appendix  D. 
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APPENDIX  C 


STEP-BY-STEP  PROCEDURE  FOB  FILE  TBAISFEBS 
FROM  A  LANIER  WORD  PROCESSOR  TO  A  PERSONAL  COMPUTER 


Note:  [LW]  Beane  'at  the  Lanier*  and  [PC]  Mane  'at  the  PC.* 

Name  of  keys  are  underlined.  We  chow  PC  commands  with  one  optional 
e pace  between  parte  and  before  Retrn.  To  get  Croeetalk’e  command 
prompt  (Command?) ,  preee  fee  or  swltoh  screene  by  pressing  Home. 

A  symbol  like  your_page_naM  stands  for  a  name  you  pick. 

1.  [LW]  Turn  on  the  Lanier.  Put  the  Lanier  disk  labelled  No  Problem  TTY- 
ASCII  Data  Communications  in  the  upper  drive  and  close  the  door.  Push  the  red 
load  (boot)  button.  The  TTY-ASCII  program  will  bo  loaded  and  start  executing. 
Remove  the  TTY-ASCII  disk. 

2.  [LW]  Put  the  communication  table  disk  marked  LCTABLE  in  the  upper  drive 
and  close  the  door.  Load  table  COMMUNITAB  by  typing: 

FNC  +  L  ♦  COMMUNITAB  ♦  EXEC 

Remove  the  table  disk. 

3.  [LW]  Oo  to  offline  editor  mode  and  set  the  page  width  to  144  by  typing: 

FNC  ♦  E  +  EXEC 
FRIT  +  H  ♦  144  ♦  EXEC 
FNC  +  C  ♦  EXEC 

The  third  command  returns  to  communications  mode.  This  step  is  a  precaution 
against  line  truncation  during  transmission. 

4.  [PC]  Turn  on  the  PC.  Put  the  system  disk  marked  PCXTALK  far  into  the  A 
(upper)  drive  and  close  the  door.  Hold  down  Ctrl  and  Alt,  and  press  Del.  MS- 
DOS  will  be  loaded  and  start  executing.  Enter  date  and  time  when  prompted. 

5.  [PC]  If  any  PC  disk  you  plan  to  use  in  the  session  is  not  forMtted, 
format  It  now.  But  first  make  sure  the  disk  holds  no  valuable  data.  Put  it 
in  drive  B  and  list  its  file  directory  Information  by  typing: 

DIR  B:  Retrn 

If  the  disk  is  not  formatted,  a  'Disk  error*  Mssage  eventually  appears.  If  a 
directory  listing  shows,  make  sure  each  file  in  each  directory  is  worthless. 
THE  FORMAT  COMMAND  DESTROYS  ALL  DATA  ON  THE  DISK  IT  FORMATS,  SO  BEFORE  USING 
IT.  BE  SURE  IT  IS  OX  TO  DESTROY  ALL  DATA  ON  THAT  DISK.  If  sure,  type: 

FORMAT/V  B:  Retrn 

When  told  to  'insert  new  diskette,*  do  it  if  not  done  and  press  the  spacebar. 
When  asked  for  a  volume  label,  enter  up  to  11  of  the  characters  acceptable  in 
file  nams,  but  not  dot.  Repeat  this  step  for  each  unformatted  disk. 

6.  [PC]  Make  sure  that  drive  A  is  the  current  drive. 
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7.  [PCI  Start  the  Croaatalk  XTI  communication  program  by  typing: 

XTALK  LABI EH  Betrn  or  XL  Betrn 
Get  tha  atatua  aoraan.  Look  at  it.  Than  gat  tha  terminal  aoraan. 

8.  [PC]  Proa  your  tranafar  plan  dataraina  which  fila  in  which  directory  on 
which  PC  diak  will  capture  (receive)  tha  data  unit  (page  or  text)  to  be  aant 
next.  If  tha  diak  ia  not  in  drive  B,  put  it  there. 

0.  [PC]  Gat  tha  tarainal  acreen,  gat  'Command?',  and  type: 

DI  B:  Betrn 

Make  aura  tha  capture  fila'a  naaa  ia  not  on  tha  directory  liat  (aaa  atep  13). 

10.  [LW]  Proa  your  tranafar  plan  dataraina  which  page  or  text  on  which  Lanier 

diak  to  aand  next.  If  the  diak  ia  not  in  tha  upper  drive,  put  it  there. 

11.  [LW]  If  unaura  of  the  data  unit'a  naaa  or  of  ita  praaenca  on  the  diak, 

have  the  offline  editor  ahow  tha  diak'a  index  (table  of  contanta)  by  typing: 

FBC  +  E  ♦  EXEC 
FILE  *  I  ♦  EXEC 
FSMT  ♦  H  ♦  144  ♦  EXEC 
PMC  ♦  C  ♦  EXEC 

Tha  laat  two  cowmanda  raaat  tha  page  width  and  return  to  coaaunicationa  mode. 

12.  [LW]  Type  one  of  tha  following  (do  not  yet  p rear  EXEC): 

CMC  ♦  T  ♦  P  ♦  y ourpaganaaa 
CMC  ♦  T  ♦  T  ♦  your  text  naaa 
CMC  +  T  ♦  D 

where  T  atanda  for  tranaait,  P  for  page,  T  for  text,  D  (rarely  uaed)  for  diak. 

13.  [PC]  Oat  'Command?'  and  tall  Croaatalk  to  taka  data  by  typing: 

CA  B:your_captura_f ile_naae  Betrn 

where  your_capture_f ile_naae  ia  tha  fila  apacifier  of  the  receiving  fila.  If 
it  exiata,  you'll  be  atked  to  append  to  it,  write  over  it,  or  pick  a  new  name. 

14.  [LW]  Start  tranamltting  by  preaalng: 

EXEC 

To  atop  tranamltting  in  an  emergency  type  CITRL/CHCL  and  PMC  ♦  C  +  EXEC 

15.  [PC]  Whan  tha  tranamiaaion  la  dona,  gat  'Command?'  and  atop  capturing: 

CA  OFP  Betrn 

Thia  eavee  tha  capture  fila.  If  you  have  more  to  aand,  go  back  to  atap  8. 
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16.  [PC]  To  view  any  capture  file,  jet  ‘Command?'  and  type: 

8U  MB  your_capture_f i le_name  Betrn 

which  cauaes  a  return  to  MS-DOS,  a  showing  of  the  capture  file  by  MORE,  and  a 
return  to  Crosstalk.  To  tell  MORE  to  show  the  next  screen,  press  spacebar. 

17.  [PC]  If  you  wish  to  capture  two  or  sore  data  units  in  the  sane  capture 
file,  you  can  leave  it  open  (omit  step  IS)  until  the  last  data  unit  is 
received  and  onit  steps  0  and  13  when  sending  the  second  and  following  units. 
But  between  data  unit  transfers,  accidentally  or  otherwise  pressing  Lanier 
keys  nay  cause  characters  to  be  received  in  the  capture  file.  These  any 
produce  unwanted  effects.  So  be  careful. 

18.  [PC]  Stop  Crosstalk  by  getting  'Connand?'  and  typing: 

QU  Betrn 

This  teroiinates  PC  communicaions  and  brings  back  the  MS-DOS  prompt.  Now  you 
can  use  MS-DOS  coomands,  such  as  DIB  and  MOBE. 

19.  [LW]  and  [PC]  Remove  your  disks  from  the  machines.  Collect  all  your 
disks  and  other  items. 

20.  [LW]  and  [PC]  Put  disks  TTY-ASCII,  LCTABLE  and  PCXTALK  in  their  box. 

21.  If  no  one  is  ready  to  use  the  Lanier-to-PC  system,  tell  the  scheduler  and 
the  next  group  scheduled  that  you  are  done.  Turn  off  the  Lanier,  the  PC,  and 
all  other  Lanier-to-PC  system  equipment.  See  that  the  system  disk  box  is  put 
in  its  safe  storage  place.  Take  all  your  items  with  you  when  you  leave. 

THANXS 
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APPENDIX  D 


PROCEDURE  FOB  DATA  CONTXBSION 
FROM  LANIEB  EXTERNAL  FORMAT  TO  DOCUMENT  INTERCHANGE  FORMAT 


Appendices  B  and  C  describe  a  procadura  uaad  to  tranafar  taxt  filaa  from  the 
Laniar  word  procaaaor  to  an  IBM  or  Sparry  PC.  Tha  PC  fila  racaivad  from  the 
Lanlar  la  In  Laniar  axtarnal  format  (LEF) .  Thla  appandix  daacrlbaa  a 
procadura  for  converting  a  PC  fila  in  LEF  to  a  PC  fila  in  Document  Interchange 
Format  (DIF).  Tha  program  LEFDIF  doaa  tha  convaraion  procaaaing.  It  can  be 
dona  in  an  IBM  or  Sparry  PC  or  in  a  Zenith  248  PC.  For  information  on  how  to 
atart  a  Zenith  248  PC  aaa  aaction  E.l. 

Section  D.l  telle  how  to  uaa  program  LEFDIF.  Section  D.2,  which  ia  for 
aoaaona  modifying  the  LEFDIF  program,  tel la  how  to  compile  and  link  LEFDIF. 

D.l  How  to  Uaa  Procaaaor  LEFDIF. 

Section  D.1.1  covera  the  LEFDIF  command  and  dome  DOS  commanda  done  before 
executing  it.  Section  D.1.2  covera  paramatere  which  LEFDIF  requaata  from  the 
uaar . 

D.1.1  Tha  LEFDIF  Command  and  Soma  DOS  Commanda  Dona  before  Executing  It. 

Program  LEFDIF.EXE  does  all  LEF-to-DIF  format  convaraion  procaaaing. 

LEFDIF.EXE  ia  on  tha  PC  diak  called  PCXTALK  uaad  in  tha  Sparry  PC 'a  A  drive  in 
tha  Lanior-to-PC  fila  tranafara  daacribad  in  Appandix  C.  The  LEF-to-DIF 
convaraion  can  bo  done  in  the  Sparry  PC  after  a  Laniar-to-PC  tranafar.  For 
example,  aaauming  that  tha  currant  drive  and  directory  are  the  A  drive  and  its 
root,  you  can  convert  LEF  fila  MEMO. LEF  on  drive  B  to  a  DIF  file  on  drive  B  by 
typing: 


LEFDIF  B: MEMO. LEF  B.IBMO.DIF  Retrn. 

Thla  cauaea  LEFDIF  to  input  (road)  MEMO. LEF  and  output  (write)  MEMO. DIF.  In 
general,  the  LEFDIF  input  and  output  file  namaa  may  have  any  extension  or 
none . 

Since  we  have  only  one  Laniar-to-PC  system,  we  may  want  to  do  tha  LEF-to-DIF 
convaraion  on  another  PC. 


Thera  are  several  ways  to  do  a  LEF-to-DIF  conversion  on  a  Zenith  248  PC.  We 
will  describe  one  way,  continuing  tha  example  begun  above.  Wa  will  use  only 
two  directories:  tha  root  directory  of  tha  diak  in  tha  Zenith’s  A  drive  and 
the  root  directory  of  tha  disk  in  its  C  drive.  If  procaaaor  LEFDIF.EXE  is  not 
in  the  C  drive's  root  directory,  we  will  put  it  there  by  copying  it  from  a 
disk  in  the  Zenith's  A  drive.  Diak  PCXTALK  contains  LEFDIF.EXE  in  its  root 
directory.  To  do  tha  copy  typo: 


A:  Return 
CD  \  Return 
C .-  Return 
CD  \  Return 

COPT  ATLiFDIF.RXE  Return 
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where  CD  mui  ‘change  directory."  Tha  first  two  linaa  make  tba  A  driva  tba 
currant  driva  and  aaka  tba  a  driva  root  (\)  diractory  tba  currant  A  driva 
diractory.  Tha  naxt  two  linaa  aaka  tha  C  driva  tba  currant  driva  (for  tha 
raat  of  tha  axaapla)  and  aaka  tba  C  driva  root  (\)  diractory  tba  currant  C 
driva  diractory.  Tha  last  lina  copiaa  procaaaor  LEFDIF.EXE  to  that  diractory. 
Tha  copy’s  naaa  is  tha  saa a  as  tha  original’s,  sinca  no  naa  naaa  is  spacifiad. 

Vow  we  put  a  disk  containing  MEMO.LEF  in  tba  A  driva  and  typa: 

LEFDI7  A : MEMO . LEF  A: MEMO. DIF  Baturn 

Than  wa  copy  tha  rasulting  DIF  fila  to  tha  C  drive’s  root  diractory  by  typing: 
COPT  A: MEMO. DIF  Baturn 

This  puts  tha  DIF  fila  in  a  good  position  for  transfer  to  a  DMIIS  node  (saa 
Appendix  E) .  If  tha  A  driva  root  has  several  DIF  files,  you  can  copy  than  all 
to  the  C  drive’s  root  by  typing: 

COPT  A: * .DIF  Baturn 

where  tha  global  character  •  matches  any  filename. 

D.1.2  Parameters  Which  LEFDIF  Bequests  from  tha  User. 

Whan  processor  LEFDIF  starts,  it  asks  tha  operator  for  tha  values  of  certain 
parameters  which  tha  Lanier  does  not  communicate  to  tha  PC.  Following  are  tha 
abbreviations,  names  and  definitions  of  these  and  soma  others: 

LM  Left  Margin  Tba  number  of  tha  leftmost  column  of  the  body 

text. 

BM  Bight  Margin  Tha  number  of  tha  rightmost  column  of  the  body 

text. 

PW  Page  Width  Tba  maximum  number  of  characters  par  lina. 

PL  Page  Length  The  maximum  number  of  Unas  to  bo  printed  par 

page. 

TM  Top  Margin  The  number  of  tha  topmost  line  on  which  body 

text  can  be  printed. 

BM  Bottom  Margin  Tha  number  of  tha  bottommost  line  on  which 

body  text  can  bo  printed. 

HS  Horizontal  Spacing  The  number  of  characters  par  inch. 

VS  Vertical  Spacing  The  number  of  linos  par  inch. 

TW  Text  Width  The  maximum  number  of  characters  in  one  body 

text  lina. 

TL  Text  Length  The  maximum  number  nt  body  text  lines  on  one 

page. 

BS  Body  Start  The  number  of  lines  from  tba  top  edge  of  tba 

paper  to  tha  first  body  text  lina. 

BE  Body  End  The  number  of  lines  from  tha  bottom  edge  of 

tha  paper  to  tba  last  body  text  lina. 

Tha  first  eight  definitions  are  essentially  from  tba  DIF  standard,  tba  naxt 
two  are  derivable  from  tha  first  eight,  while  tha  last  two  are  from  Q-One.  In 
specifying  TM  and  BM  tha  line  at  tha  top  edge  of  tha  paper  is  lina  1.  Lanier 
pages  do  not  have  headers  and  footers.  For  example,  if  you  want  one- inch  top 


and  bottoa  aarglns  and  VS  is  6  and  PL  is  66,  than  sat  TM  to  7  and  BM  to  60. 
This  will  causa  tha  DIF-to-QIF  convartar  to  sat  BS  and  BE  to  7 . 


Following  ara  examples: 


Type 

LM 

BM 

PW 

PL 

TM 

BM 

HS 

VS 

TW 

TL 

BS 

BM 

A 

1 

80 

85 

66 

7 

60 

10 

6 

80 

54 

7 

7 

B 

11 

75 

85 

66 

7 

60 

10 

6 

65 

54 

7 

7 

C 

12 

06 

06 

66 

7 

60 

12 

6 

85 

54 

7 

7 

D 

13 

00 

102 

88 

0 

80 

12 

8 

78 

72 

9 

9 

These  values  assume  8- 

■1/2 

inch 

by 

11  inch 

paper . 

This 

amounts 

to 

85  or 

102 

columns,  depending  on 

the 

value 

of 

HS  (10 

or 

12)  . 

If  a 

Lanier 

page  is 

racallad,  its  LM,  BM,  PW  and  PL  valuas  can  ba  obtainad  visually  from  tha  top 
scraan  lina  as  L,  B,  H  and  V.  Tha  Lani ar  doas  not  sand  to  tha  Sperry  PC 
valuas  for  LM,  BM,  PW,  PL,  TM  or  BM.  For  LM  it  sands  at  tha  start  of  each 
line  just  enough  spaces  to  make  tha  next  character  go  into  the  LM  column.  It 
also  sends  a  DEL  (7F)  character  after  each  page. 

LEFDIF  requires  the  first  eight  values:  LM,  BM,  PW,  PL,  TM,  BM,  HS  and  VS. 
LEFDIF  first  shows  you  the  standard  settings: 


1  left  margin 
60  right  margin 
85  page  width 
66  page  length 


7  top  margin 
60  bottoa  margin 
10  horizontal  spacing 
6  vertical  spacing 


and  asks  if  you  want  to  use  thea.  If  you  do,  LEFDIF  proceeds  to  process  the 
input  file.  Otherwise,  it  prompts  you  for  each  of  the  first  six  values  and 
uses  10  and  6  for  HS  and  VS. 


LEFDIF  checks  the  LEF  file's  left  margin,  and  displays  the  number  of  each  line 
whose  left  margin  is  less  than  the  one  you  specified.  If  it  finds  any  such 
lines,  LEFDIF  terminates  to  allow  you  to  fix  the  lines  or  decide  on  a 
different  left  margin,  and  then  run  LEFDIF  again. 

If  the  left  margin  is  OK,  LEFDIF  reads  the  LEF  file  and  produces  the  DIF  file. 
If  a  set  of  nonstandard  settings  is  used  frequently,  time  can  be  saved  by 
putting  them,  one  per  line,  in  a  BESP0ISE  FILE  and  redirecting  LEFDIF's 
questions  to  that  file.  For  example,  if  the  margins  are  standard  except  for 
left  and  right  margins  of  11  and  70,  the  response  file  would  contain  these 
eight  lines: 

I  Return 

II  If turn 
70  Return 
85  Return 
66  Return 
7  Return 
60  Return 
Y  Return 

where  M  answers  ‘Use  standard  settings? ",  and  T  answers  'OK?'.  For  example, 
if  the  input  file  is  NABB0W.LEF  and  the  response  file  is  LDBESP70,  type: 
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LEFDIF  A: MARROW. LEF  A:IASBOW.DIF  <  LDRESP70 

and  LEFDIF  will  complete  without  wort  typing  (unless  it  detects  an  arr or). 

A  response  file  ia  an  ordinary  taxt  fila.  You  can  build  ona  using  the  COPY 
command.  For  exaapla,  typa: 

COPY  COM:  LDBESP70 
f  Return 
11  Return 
70  Saturn 
83  Return 
00  Return 
7  Return 
60  Saturn 
Y  Saturn 
F0  Return 

where  COM:,  weaning  'the  conaola  device*  (keyboard),  apeciflaa  the  input  to 
the  copier,  and  the  laat  line  uaea  a  function  key  to  end  copying.  Thia  ia  a 
simple  way  to  build  a  small  file,  but  you  cannot  change  a  mistake  in  a  line 
after  you  have  entered  that  line. 

After  the  LEF-to-DIF  conversion,  the  MS-DOS  commands  MORE  (if  available)  and 
TYPE  will  display  DIF  files  at  80  characters  per  line,  showing  control 
characters  as  special  display  symbols  (see  Figure  4  in  Appendix  A) .  For 
example,  to  display  MEMO. DIF  type  one  of  the  following: 

MORE  <  MEMO. DIF  Setrn 
TYPE  MEMO. DIF  Setrn 

The  information  given  in  this  section  is  enough  for  using  LEFDIF. 

D.2  How  to  Compile  and  Link  LEFDIF. 

LEFDIF  is  written  in  the  C  programming  language  and  is  compiled  and  linked 
using  a  Microsoft  C  Compiler  and  Linker. 

The  COMPILATIOM  has  two  phases,  which  may  be  depicted  thus: 

LEFDIF. C  ->  phase  1  ->  LEFDIF. Q  ->  phase  2  ->  LEFDIF. OBJ 

The  file  input  to  phase  1,  called  the  'source  file,*  must  have  name  extension 
C.  Each  source  file,  such  as  LEFDIF. C,  which  refers  to  a  standard  library 
function  must  contain  near  its  beginning  the  line: 

•include  <stdio.h> 

File  STDIO.H  contains  certain  things  required  by  such  references.  Phase  1 
outputs  an  intermediate  'quad*  file  with  name  extension  Q.  Phase  2  produces 
an  object  file  with  name  extension  OBJ.  This  file  is  input  to  a  linker, 
program  LIIX.EXS,  which  produces  an  executable  program,  in  this  case 
LEFDIF.EXE. 

LINXI1Q  requires  two  special  tiles,  whose  names  depend  on  the  memory  model  to 
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be  used,  which  is  indicated  by  the  letter  S,  P,  D  or  L.  We  use  the  S  (smell) 
model,  for  which  the  special  files  are  CS.OBJ  and  MCS.L1B.  CS.OBJ  defines  the 
program's  execution  entry  and  exit  points.  It  must  be  specified  first  in  the 
link  command.  MCS.LIB  is  a  library  file  defining  runtime  and  input/output 
library  functions. 

Figure  5  shows  the  names  of  the  files  required  for  compiling  and  linking 
program  LEFDIF,  and  the  the  commands  for  doing  so.  Messages  resulting  from 
the  commands  are  also  shown.  Vote  that  file  name  extensions  are  not  required. 
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C>dir 

Volume  In  drive  A  ia  DISK  01 
Directory  of  A:\mac 


' 

<DIR> 

0-12-86 

6 : 14p 

,  , 

<DIR> 

0-12-86 

6: 14p 

STDIO 

H 

1803 

11-22-83 

11:08a 

MCI 

EXE 

04806 

4-00-84 

3:52p 

MC2 

EXE 

05064 

4-00-84 

4 :  OOp 

CS 

OBJ 

1003 

11-22-83 

12 : 32p 

MCS 

LIB 

70300 

4-00-84 

8 : 40p 

LIHK 

EXE 

39080 

12-00-83 

12: 17p 

LEFDIF 

C 

8000 

0-12-86 

7 : 16p 

LEFDIF 

OBJ 

5050 

11-06-86 

12: lOp 

LEFDIF 

EXE 

14702 

11-00-86 

12: lOp 

C>mcl  lefdif 

Ulcroaoft  C  Compiler  (Pheae  1)  V2.03 

Copyright  (C)  1083  by  Lattice,  Inc. /Lifeboat  Aaaoclatea 
C>mc2  lefdif 

Microaoft  C  Compiler  (Pheae  2)  V2.03 

Copyright  (C)  1983  by  Lattice,  Inc. /Lifeboat  Aaaoclatea 
Module  aize  Pn085F  D*0396 

Olink  ca  ♦  lefdif,  lefdif,  nul ,  mca 

C> 


Figure  5.  Filea  Required  for  Compiling  and  Linking  Program  LEFDIF 
and  the  Commanda  Uaed  to  Do  So. 
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APPENDIX  E 

ZSTEM  PROCEDURES  FOR  FILE  TRANSFERS 
BETWEEN  A  ZENITH  248  PERSONAL  COMPUTER 
AND  A  DLA  DM I NS  COMPUTER 


This  appendix  tells  how  to  do  a  Kermit  -file  transfer  -from  a  CO-LAN-connected 
(see  section  2.3.1)  Zenith  248  Personal  Computer  (PC)  to  a  DLA  DMINS  computer 
using  Zenith's  ZSTEMpc  communications  program,  which  we  will  call  ZSTEM.  We 
assume  that  you  know  how  to  start  the  ZSTEM  program  in  the  Zenith  you  use,  now 
to  connect  with  the  DLA  DMINS  computer,  and  how  to  bring  up  the  DMINS  main 
menu. 

Section  E. 1  tells  how  to  start  a  Zenith  248  PC  and  use  it  to  log  into  the  DTIC 
DMINS.  Section  E.2  describes  the  ZENITH's  ZSTEM  communications  program. 
Section  E.3  covers  Kermit  file  transfers  between  a  Zenith  248  PC  and  a  DLA 
DMINS.  Section  E.4  gives  examples  of  such  file  transfers. 

E. 1  How  to  Start  a  Zenith  248  PC  and  Log  into  the  DTIC  DMINS. 

Zenith  248  PCs  are  standard  components  of  DLA  DMINS  systems.  Each  contains  a 
floppy  disk  drive  and  a  hard  disk  drive.  These  are  the  A  and  C  drives, 
respecti vel y .  Files  can  be  transferred  to  or  from  the  root  directory  or  a 
subdirectory  of  ei ther  drive. 

In  the  DTIC  DMINS  a  Zenith  248  PC  and  its  ALPS  P2000G  or  other  printer  are 
each  typically  connected  by  a  power  cord  to  an  outlet  in  a  nearby  power  strip 
on  the  floor  or  on  the  desk:  or  table  holding  the  PC.  The  PC  and  printer  each 
has  its  own  on/off  switch  which  are  often  left  on  when  the  power  strip  is 
switched  off.  If  these  are  off,  switch  them  on.  Switch  on  the  power  strip. 
This  will  cause  the  PC  to  do  some  initialization  and  then  present  the  prompt: 

C:\> 

which  says  that  the  C  drive  (C: )  is  the  current  drive,  that  the  root  directory 
(\>  is  the  current  directory,  and  that  MS-DOS  is  waiting  <>)  for  a  command 
from  the  user. 

To  communicate  with  the  DMINS,  we  use  a  copy  of  the  ZSTEM.COM  communications 
program  which  has  been  configured  for  such  communication.  "Configured"  here 
means  that  port  number,  baud  rate  and  other  parameters  have  been  set  to 
appropriate  values.  For  example,  the  baud  rate  is  set  to  9600.  We'll  assume 
that  the  configured  copy  is  in  the  root  directory,  that  this  is  the  current 
directory,  and  that  ZSTEM.COM  has  been  renamed  DMINS.COM.  (If  this  is  not  the 
case,  find  out  the  name  and  location  of  the  configured  copy  from  someone  who 
knows.  ) 

To  start  communicating  type: 

DMINS 

and  get  a  response  like: 
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ZSTBMpc :  VT100  SMART  TERMINAL  EMULATOR  (V2.4P1) 

Copyright  (C)  KEA  Systems  Ltd  1084.1885 

RESTRICTED  RIGHTS  LEGEXD 

‘Use,  duplication,  or  disclosure  by  the  .  .  . 

OBIGIM:  MODE  cndkl  MODULE  52  PORT  3 

WELCOME  TO  CAMEBOM  CO-LAM  MODE  1 

DESTINATION: 

where  we  have  shortened  the  legend.  ‘CO-LAM*  refers  to  s  Bell  Atlantic 
Central  Office  based  Local  Area  Network  which  allows  customers  to  share 
Information  and  resources  by  connecting  terminals,  workstations  and  computers. 

Mow  type: 

?  Return 

and  see: 


? : 

CAMERON  MODE  1 

AREA: 

703: 

Northern  Virginia 

EXCH: 

100: 

Cameron  Mode  0 

110: 

Cameron  Mode  1 

LOCAL: 

1000: 

DTI C  DMIMS  HOST  1 

DESTINATION: 

Mow  type: 

110/1000  Return 

where  1000  alone  is  often  sufficient,  and  see  something  like  this: 

GOULD  UTX/32  2.0U01  (CSD-UBB)  (dticgl)  (tty92) 
login: 

After  you  enter  your  login  and  password,  the  DMIMS  main  menu  is  displayed: 
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DEFENSE  LOGISTICS  AGENCY 
DATA  SYSTEMS  AUTOMATION  CENTER 


1  Chang*  Your  Password 

2  Q-Office  (Word  Proc  /  Mail) 

3  Data  Baa* 

4  Electronic  Mail  Forwarding 

5  Buain***  Graphic* 

6  20/20  Spr*ad*h**t 

7  Lock  thia  Terminal 

8  Phonebook 

9  Bourn*  Shall 

10  C  Shell 

11  CAI  Couraea 

12  INFO 


Enter  option  or  ’x*  to  logout 
E.2  Use  of  the  ZSTEM  Communications  Program 

Actually,  there  are  two  veraion*  of  ZSTEM:  the  text  version  ZSTEM.COM,  and  the 
graphics  veraion  ZSTEMG.COM. 

ZSTEM  provides  two  distinct  modes  of  operation: 

terminal  mode  (or  emulation  mode) ,  in  which  your  computer  functions 
like  a  terminal. 

command  mod#  (or  alternate  mode) ,  in  which  you  can  enter  ZSTEM 
commands  to  modify  the  configuration,  initiate  file  transfers,  or 
access  other  extended  features. 

ZSTEM  starts  in  emulation  mode.  You  can  switch  to  command  mode  at  any  time  by 
pressing  Alt,  which  causes  the  prompt: 

ZSTEM? 

to  be  displayed  on  the  25th  line.  You  can  then  enter  ZSTEM  commands.  You  can 
display  a  list  of  ZSTEM  commands  by  typing: 

HELP  Return 

Many  ZSTEM  commands  prompt  you  to  select  a  subcommand  or  a  value. 

When  in  ZSTEM  command  mode,  remember: 

1.  Any  prompt  that  ends  with  a  question  mark  (?)  requires  you  to  type 
a  line  of  text  and  then  press  Return. 

2.  Any  prompt  that  ends  with  a  colon  (:)  requests  that  you  type  one 
character  and  press  Return.  The  default,  shown  in  square  brackets,  is  chosen 
by  just  pressing  Return. 
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3.  Any  prompt  that  ends  with  three  period!  (...)  requirea  a  single 
keypreaa  only. 

4.  If  an  error  occura  during  command  processing,  an  error  message  la 
displayed  on  the  25th  line. 

5.  You  need  enter  only  enough  of  the  initial  part  of  a  command  name 
to  make  it  unique.  For  example,  the  list  of  ZSTEM  commands  can  be  displayed 
by  entering  HE  at  the  ZSTEM?  prompt. 

6.  You  can  type  ahead  at  the  following  command  prompts: 

ZSTEM? 

Send,  Qet,  Receive,  Directory,  Finish,  or  Command: 

Select  item? 

The  second  line  is  ZSTEM  Hermit's  main  menu.  The  third  is  from  the  COMFIQURE 
program.  Typing  ahead  saves  time  by  eliminating  prompts.  Instead  of  entering 
the  command  and  then  answering  prompts  for  subcommands  or  values,  pressing 
Return  after  each,  you  can  enter  the  respective  responses  all  in  one  line, 
separated  only  by  a  space.  For  example,  at  the  ZSTEM?  prompt  you  could  enter: 

BAUD  REMOTE  9600 


or 


B  R  9600 

To  embed  a  Return  in  a  type  ahead  use  the  null  string  ".  You  can  enter 
multiple  commands  in  one  type  ahead  if  you  separate  them  by  null  strings. 

To  return  to  terminal  mode,  press  Return  at  the  ZSTEM?  prompt.  To  terminate 
ZSTEM  and  return  to  MS-DOS  command  mode,  enter  EXIT  at  the  ZSTEM?  prompt. 

EXIT  may  or  may  not  hang  up,  that  is  disconnect  communications,  depending  on 
the  value  of  a  setting  in  the  Zenith's  configuration.  If  'hangup  and  exit*  is 
not  set ,  enter  HAMQUP  before  entering  EXIT.  If  you  are  finished  with  the 
DMINS,  make  sure  disconnection  takes  place. 

E.3  Kermit  File  Transfers  between  a  Zenith  248  PC  and  a  DLA  DMIMS. 

To  start  a  Kermit  file  transfer  between  a  Zenith  248  PC  and  a  DLA  DMIMS 
computer,  two  Kermit  processors  must  be  running:  one  in  the  PC  and  another  in 
the  DMIHS  minicomputer.  A  Xermit  processor  is  a  communications  processor 
which  implements  the  Kermit  comsiunications  protocol  (see  Appendix  6) .  The 
ZSTEM  communications  program  includes  a  Kermit  processor.  The  DMIMS  computer 
has  a  Unix  Kermit  processor,  which  is  a  remote  Kermit  in  server  (host)  mode. 

An  example  of  the  whole  command  sequence  for  a  Zenith  to  DMIMS  transfer  and 
one  for  a  DMIMS  to  Zenith  transfer  are  shown  in  sections  E.4  as  examples  A  and 
B,  respectively. 

To  send  a  PC  file  to  a  DMIMS,  get  the  DMIMS  main  menu  and  select  C  Shell  (item 
10).  This  puts  you  in  the  Unix  C  Shell  environment,  where  the  prompt 
character  is  the  percent  sign  (X).  To  start  the  Unix  Kermit  processor  type: 
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kermit  -r  Return 


using  lower  case  letters.  The  Unix  Kermit  will  wait  for  characters  sent  from 
the  Zenith.  Immediately  press  Alt  to  get  the  ZSTEM?  prompt  and  type: 

kermit 

The  Zenith  Kermit  starts  and  displays  the  following  prompt  on  the  25th  line: 

Send,  Set,  Receive,  Directory,  Finish,  or  Command: 

Enter  the  first  or  more  letters  of  the  subcommand  you  choose  or  press  Return 
to  get  back  the  ZSTEM?  prompt.  In  our  case,  type: 

s  Return 

The  Zstem  Kermit  Send  subcommand  causes  Kermit  to  send  one  or  more  local  (PC) 
files  to  the  remote  system.  Send  displays  the  following  prompt  on  the  25th 
line: 


Local  file? 

You  may  specify  a  single  file  or  specify  multiple  files  by  using  one  or  more 
wildcard  characters  (?  and  •)  in  the  file  specification.  If  your  local  file 
name  is  invalid  or  the  file  does  not  exist,  Send  reprompts  you.  To  abort 
Send,  type  no  specification  and  press  Return.  If  your  file  specification  is 
OX,  Send  prompts: 

Rmt  file  [local]: 

If  you  want  the  received  file  to  have  the  same  name  as  the  sent  file,  just 
Press  Return .  Otherwise,  enter  the  new  name.  If  the  remote  file  name  is 
invalid,  Send  reprompts  you  for  the  local  file  name.  Otherwise,  ZSTEM  starts 
sending  the  file  immediately. 

If  the  Send  command  is  entered  too  late,  the  DMIKS  Kermit  procesor  will  stop 
and  have  to  be  restarted.  To  do  this,  get  the  ZSTEM?  prompt,  press  Return  to 
get  the  Unix  prompt,  and  reenter  the  Kermit  receive  command. 

While  the  file  transfer  is  active,  ZSTEM  shows  statistics  on  the  25th  line. 

The  message  'Too  many  errors:  command  aborted'  that  an  error  retry  limit  was 
exceeded  or  the  remote  Kermit  sent  an  error  packet.  If  it  appears,  restart 
the  DMINS  kermit  processor. 

When  ZSTEM  finishes  sending  a  file,  it  logs  the  message: 

File  send  completed 

with  packet,  byte,  error  and  retry  counts. 

If  ZSTEM  cannot  finish  sending  a  file,  ’File  send  ABORTED'  is  displayed.  You 
can  abort  a  file  transfer  by  typing  Ctrl/X,  which  aborts  the  current  file,  or 
Ctrl/Z,  which  aborts  the  rest  of  the  files  in  a  group  transfer,  or  by 
presssing  Alt,  which  gets  Kermit’ s  main  menu  without  notifying  the  remote 
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Xermit . 


Whan  all  apaclflad  (lias  hava  baan  sant,  ZSTEM  Xermit's  main  menu.  After 
sanding  is  dona,  ZSTEM  Karalt’s  main  menu  Is  displayed.  You  oan  than  transfar 
none  (lias  or  stop  tha  remote  Kami t  procassor  by  using  tha  Finish  option,  in 
which  casa  the  ZSTEM?  prompt  is  displayed,  or  just  press  Return  to  get  tha 
ZSTEM?  prompt.  At  this  prompt,  you  can  gat  the  Unix  prompt  7x7,  by  just 
pressing  Saturn.  To  shorn  tha  names  o (  tha  files  in  the  currant  Unix  directory 
enter: 

Is  -1  -t  more 

which  lists  their  names  and  other  information  a  screen  at  a  time  in  reverse 
creation  time  order  (newer  before  older).  You  can  examine  a  transferred  file 
using  one  of  the  following  Unix  processors: 

ex  line  editor 

vl  visual  editor 

more  shower  of  a  page  at  a  time 

od  -a  ascii  character  dump 

For  DIF  files,  you  stay  wall  prefer  to  convert  each  to  a  Q-One  document  file 
and  examine  the  document.  The  procedure  for  such  conversions  (DIF-to-QIF)  is 
described  in  section  5.3  of  this  report. 

To  return  from  the  Unix  C  Shell  to  the  DMIKS  main  menu,  press  Ctrl/LD. 

The  rest  of  this  section  briefly  describes  the  Xermit  subcommands  other  than 
Send.  The  next  section  gives  two  exxamples  of  Xermlt  file  transfer  command 
sequences . 

The  ZSTEM  Xermit  Receive  subcommand  is  used  after  the  remote  Xermlt  server  has 
initiated  a  send,  specifying  the  file(s)  to  be  transferred.  Example  B  in 
section  E.4  shows  this. 

The  ZSTEM  Xermlt  Qet  subcommand  is  used  when  the  remote  Xermlt  is  in  server 
mode,  as  in  the  DMIVS.  It  requests  the  remote  Xermit  to  send  one  or  more 
files  to  ZSTEM.  It  is  similar  to  the  Xermit  Send  command,  but  the  receiver 
specifies  the  file(s)  to  be  transferred.  We  recommend  using  receive,  since  we 
have  been  unable  to  make  Qet  work  yet. 

The  ZSTEM  Xermit  Directory  subcommand  displays  directory  information  on  any 
drive  or  subdirectory  on  your  Zenith  PC  system.  It  displays  the  following 
prompt  on  the  25th  line: 

File  specification? 

Enter  a  drive  designator,  a  wildcard  specification,  and/or  a  directory  path 
name;  or  press  Return  to  get  the  Xermlt  main  menu.  This  subcommand  assumes  a 
wildcard  if  you  do  not  specify  a  file  name  or  file  name  extension,  so  that  the 
following  are  equivalent: 

C:» .» 

C:« 

C: 
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But  it  you  enter  a  period  without  an  extension,  only  -files  with  no  extension 
are  selected. 


The  ZSTEM  hermit  Fimis.n  subcommand  terminates  the  remote  system  hermit  when 
you  have  -finished  trans-f err ing  files.  It  transmits  a  -finish  packet  to  the 
remote  system,  causing  it  to  terminate  Kermit  and  return  to  normal  terminal 
cominun: cations.  When  this  happens,  the  ZSTEhP  prompt  is  displayed,  and  you 
car.  p'-c-sc  Return  to  ret.u-n  to  terminal  emulation.  If  the  remote  l.ermit  does 
ret  respond  to  the  finish  packet,  perhaps  having  timed  out,  ZSTEM  displays  the 
er'or  message: 

Unable  to  shut  down  server 

and  the  ZSTEhP  prompt. 

Te  ZSTEM  Kermit  Command  sutcommand  sends  commands  to  MS-DOS  cr  to  a  remote 
kermit.  It  prompts: 

Local  (DOS).  Remote,  or  Kermit 

We  will  consider  only  an  example  of  use  of  the  Local  option  in  a  type  ahead. 
Suppose  at  the  ZSTEM'’’  prompt  you  enter: 

t  C  _  DIR 

This  causes  ZSTEM  to  exit  to  MS-DOS,  perform  the  MS-DOS  DIR  command,  anc 
return  Lo  the  Kermit  mair  menu.  In  this  case  the  MS-DOS  command  displays 
information  in  the  current  directory,  giving  more  than  does  the  ZSTEM  hermit 
Directory  subcommand. 

When  finished  with  ZSTEM  Kermit,  press  Retrn  until  you  get  the  Unix  prompt. 
Then  t /pe  Ctrl/D  to  get  the  DMINS  main  menu.  Select  EXIT  (item  :< )  and  qe  trie 
DESTINATION  prompt.  "hen  press  Al_t  to  get  the  ZSTEM?  prompt  and  type: 

ha  y  Retrn 

to  hang  up  and  return  i-o  MS-DOS  command  mode. 
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E.4  Examples  of  Fils  Transfers  Using  the  DMIIS  Unix  and  ZSTEM  Kermit 
Processors. 

EXAMPLE  A.  Use  the  DMIKS  Unix  and  ZSTEM  Keralt  processors  to  send  a  file 

called  HEWFOLXS  from  a  Zenith  248  PC  to  a  DMINS  computer.  Then 
get  the  DMIKS  main  menu. 

1.  Set  the  DMIKS  main  menu. 

2.  Select  C  Shell  (item  10)  and  get  the  Unix  prompt  (X). 

3.  Type  'kermit  -r  Be turn*. 

4.  Press  Alt  to  get  the  ZSTEM?  prompt. 

5.  Type  'kermit  send  newfolks  Return " . 

6.  Press  Return  when  prompted  for  the  remote  file  name. 

7.  Press  Return  to  get  the  Zstem?  prompt  after  the  transfer  is  done. 

8.  Press  Return  again  to  get  terminal  mode  and  the  Unix  prompt. 

9.  Press  Ctrl/D  to  get  the  DMIKS  main  menu. 

After  step  6  a  Kermit  statistics  line  is  displayed  and  updated.  When  the 
transfer  is  done,  a  ‘File  send  completed*  message  with  statistics  is 
displayed.  Then  the  Zstem  Kermit  main  menu  is  displayed. 

Mote  that  in  PC  file  names,  letters  are  upper  case  but  may  be  typed  in  upper 
or  lower  case,  while  in  Unix  file  names,  the  case  of  a  letter  makes  a 
difference,  and  lower  case  letters  are  usually  used. 
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EXAMPLE  B.  Use  the  DMINS  Unix  end  ZSTEM  Kermit  processors  to  send  a  file 

called  AGENDA  from  a  DMINS  computer  to  a  Zenith  246  PC,  supposing 
AGENDA  to  be  in  subdirectory  IOM  immediately  under  the  current 
directory.  Then  get  the  Zstea?  prompt. 

1.  Get  the  DMINS  main  menu. 


2.  Select  C  Shell  (item  10)  and  get  the  Unix  prompt  (X). 

3.  Type  'kermit  -s  IOM/ AGENDA  Return*. 

4.  Press  Alt  to  get  the  ZSTEM?  prompt. 

5.  Type  ‘kermit  receive  Return  * . 

6.  Press  Return  or  enter  a  file  specifier  when  prompted  for  the 
local  file  name. 

7.  Type  ‘C  L  DIR  Return*  to  see  the  current  Zenith  directory. 

8.  Press  Return  to  get  the  Zstem?  prompt  after  the  transfer  is  done. 


After  step  6  a  Kermit  statistics  line  Is  displayed  and  updated.  When  the 
transfer  is  done,  a  ‘File  receive  completed*  message  with  statistics  is 
displayed.  Then  the  Kermit  main  menu  is  displayed. 


Note  that  in  PC  file  names,  letters  are  upper  case  but  may  be  typed 
or  lower  case,  while  in  Unix  file  names ,  the  case  of  a  letter  makes 
difference,  and  lower  case  letters  are  usually  used. 


in  upper 

a 


APPENDIX  F 


CROSSTALK  XVI  PROCEDURES  FOR  FILE  TEAISFERS 
BETWEEN  A  SPERRY  UNIVAC  PERSONAL  COMPUTER 
AND  A  DLA  DMINS  COMPUTER 


F.l  Kerait  File  Transfers  Using  the  DMINS  Unix  and  Crosstalk  XVI  Kermit 
Processors. 


This  appendix  tells  how  to  do  a  Remit  file  transfer  from  an  IBM  or  Sperry 
personal  coaputer  (PC)  to  a  DLA  DMINS  computer  using  the  Microstuf’s  Crosstalk 
XVI  coamuni cat ions  prograa.  It  was  used  for  testing  by  dialing  up  a  DSAC 
(Coluabus,  OB)  DMINS  long  before  DTIC's  DMINS  was  installed. 

To  start  a  Kerait  file  transfer  froa  a  PC  to  a  DMINS  computer,  two  Kermit 
processors  must  be  running:  one  in  the  PC  and  another  in  the  DMINS  coaputer. 

A  Kerait  processor  is  a  communications  program  which  iapleaents  the  Kerait 
communications  protocol  (see  Appendix  0) .  The  Crosstalk  XVI  coamuni cat ions 
prograa  includes  a  Kerait  processor.  The  DMINS  Unix  also  has  a  Kerait 
processor,  which  is  a  remote  Kermit  in  server  aode. 

The  Crosstalk  XVI  coaauni cat ions  prograa  is  described  in  section  B.3  of 
Appendix  B,  which  deals  with  sending  files  froa  a  Lanier  word  processor  to  a 
directly  connected  PC.  Crosstalk  calls  this  a  ‘local*  connection.  Here  we 
consider  a  PC  and  a  remote  coaputer  connected  through  modems  and  a  telephone 
line.  The  command  we  use  to  start  Crosstalk  in  the  local  connection  setting 
is  ‘XTALK  LANIER'.  To  start  Crosstalk  in  a  DMINS  session  we  type: 

XTALK  DMINS  Retrn 


When  asked  to  enter  the  character  to  be  used  for  EOL  character,  type  Ctrl/J 
(hold  down  Ctrl  and  press  J) .  Kerait  settings  will  be  shown  and  should  be: 


Packet  size 
Timeout 
End  of  line 
Control  Quote 
Binary  Quote 
Mode 


04 

10 

*J 

• 

& 

Text-only 


If  the  ones  shown  are 


KE 

P 

04 

KE 

T 

10 

KE 

E 

Ctrl/J 

KE 

C 

« 

KE 

B 

& 

KE 

M 

T 

KE 

L 

not  these,  set  them  by  entering: 


where  the  last  command  lists  the  current  Kerait  settings.  Although  Kermit  can 
be  used  to  transfer  binary  files,  that  is,  files  containing  eight  data  bits 
per  character,  the  present  description  is  limited  to  transfers  of  ASCII  text 
files  composed  of  seven-bit  characters.  When  the  Crosstalk  Kerait  aode  is 
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text-only,  binary  file  tranafera  cannot  ba  dona,  and  tha  binary  quota 
charactar  ia  irralavant. 

Tha  procadura  for  dialing  tha  DMIMS  talaphona  n unbar  and  Baking  tha  connaction 
dapanda  on  tha  PC  coaBunicationa  hardware,  tha  aodam,  and  tha  talaphona 
aquipmant.  Onca  tha  connaction  ia  aatabllahad,  tha  procadura  ia  ralativaly 
aiapla. 

We  aaauaa  that  you  know  bow  to  atart  tha  Croaatalk  program  in  tha  PC  you  will 
uaa,  how  to  connact  with  tha  DMIMS  computer,  and  how  to  bring  up  tha  DMIMS 
main  manu. 

To  aand  a  PC  file  to  a  DMIMS,  gat  tha  Croaatalk  terminal  acraan  by  praaaing 
Home  onca  or  twica,  gat  tha  DMIMS  sain  manu  and  aalact  C  Shall  (itan  10). 

Thla  puta  you  in  tha  Unix  C  Shall  anvironaant,  wbara  tha  proapt  charactar  la 
the  percent  aign  (X) .  To  atart  tha  Unix  Kermit  proceaaor  almply  type: 

karmit  -r  Saturn 

uaing  lower  caaa  lattara.  Than  praaa  Kac  to  gat  tha  Croaatalk  COIMAND?  prompt 
and  enter  a  Karmit  aand  coamand,  with  a  file  apacifier,  which  Bay  include 
wildcarda.  The  tranafar  will  begin,  proceed,  and  and  automatically .  A 
tranamlsaion  atatua  table  will  appear  on  tha  PC’a  acraan.  Whan  the  tranafar 
ia  dona,  tha  atatua  table  will  aay  "100X  complete.' 

The  Croaatalk  procadura  for  aanding  a  DMIMS  file  to  a  PC  la  aimilar  to  tha  one 
juat  deacribad. 

Examplea  of  Karmit  file  tranafar  comaand  aequencea  are  given  on  tha  following 
pagea . 


F.2  Example*  of  File  Transfer*  Using  tbs  DMINS  Unix  and  a  Crosstalk  XVI 
Ksrmit  Processors 


EXAMPLE  A.  Using  the  DMINS  Unix  and  Crosstalk  Kermit  processors  to  send  a 
file  called  WEWFOLKS  from  an  IBM  or  Sperry  PC  to  the  DMINS 
computer. 

1.  Set  the  DMINS  main  menu. 


2.  Select  C  Shell  (item  10)  and  get  the  Unix  prompt  (X) . 

3.  Type  'hermit  -r  Return ' . 

4.  Press  Esc  to  get  the  Crosstalk  COkUAVD?  prompt. 

5.  Type  'kermit  send  newfolk*  Return ' . 

6.  When  the  transmission  is  done,  press  Betrn. 

Note  that  in  PC  file  names,  letters  are  upper  case  but  may  be  typed  in  upper 
or  lotmr  case,  while  in  Unix  file  names,  the  case  of  a  letter  makes  a 
difference,  and  lower  case  letters  are  usually  used. 

After  step  5  a  transmission  status  display  like  the  following  appears: 

Transmitting  A:NEWF0LXS 


!  Block  • 

X  complete 

Consec.  errors 

Total  errors 

:  7 

20X 

none 

2  : 

PROTOCOL  TRANSFER  UNDERWAY  --  Press  Esc  to  cancel 

When  the  transmission  is  100X  complete.  Crosstalk’s  command  line  says: 

File  transmission  complete.  Press  ENTER: 

After  pressing  Betrn,  you  can  press  Rome  to  get  the  terminal  screen,  and  then 
Interact  with  Unix. 

The  presence  of  a  count  in  either  of  the  'errors'  cells  in  the  transmission 
status  display  does  not  imply  that  the  received  file  differs  from  the  sender's 
copy,  since  such  errors  can  be  overcome  by  retransmission.  The  '100  X 
complete'  message  implies  that  the  received  file  results  entirely  from  packets 
received  with  no  error  detected. 

One  could  send  all  the  files  in  the  current  PC  directory  to  the  DMINS  computer 
by  typing  'kermit  send  *.»  Betrn'  in  step  5.  A  series  of  file  transmissions 
started  this  way  could  go  on  for  hours. 
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EXAMPLE  B.  Using  the  DMIVS  Unix  and  Crosstalk  Kerait  processors  to  send  a 

fils  called  AGIMDA  froa  the  DMIVS  coaputer  to  an  IBM  or  Bperry  PC, 
supposing  AQEYDA  is  in  subdirectory  IOM  iaaediately  under  the 
current  Unix  directory. 

1.  Get  the  DMIVS  aain  aenu. 


2.  Select  C  Shell  (itea  10)  and  get  the  Unix  proapt  (X) . 

3.  Type  ‘kerait  -s  IOM/ AGENDA  Return’ . 

4.  Pr*«s  Esc  to  get  the  Crosstalk  COMIAVD?  proapt. 

5.  Type  ‘kerait  receive  Return’ . 

0.  When  the  transaission  is  done,  press  Retrn . 


Mote  that  in  PC  file  naaes,  letters  are  upper  case  but  Bay  be  typed  in  upper 
or  lower  case,  while  in  Unix  file  naaes,  the  case  of  a  letter  Bakes  a 
difference,  and  lower  case  letters  are  usually  used. 


After  step  5,  transaission  status  is  displayed  as  in  Exaaple  A.  The 
coapletion  indications  and  the  procedure  after  coapletion  are  the  sane  as  in 
Exaaple  A. 
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APPENDIX  G 


DESCRIPTION  OF  THE  KEBMIT  FILE  TBAHSFEB  PBOTOCOL 


This  appendix  briefly  describes  the  Xermit  file  transfer  protocol.  This 
information  in  it  is  not  required  for  transferring  files  by  using  the  steps 
given  above,  but  is  presented  for  anyone  wanting  a  brief  overview  of  Kermit. 

It  is  based  on  the  two-part  article  ‘Kermit:  A  File-Transfer  Protocol  for 
Universities,'  by  Frank  Da  Crus  and  Bill  Catchings,  in  the  June  and  July  1984 
issues  of  Byte . 

KERMIT  is  a  portable  f ile-transfer  communication  protocol.  Here  PBOTOCOL 
means  a  set  of  rules  for  forming  and  transmitting  packets,  carried  out  by 
programs  that  embody  those  rules.  Programs  implementing  Kermit  are  written  in 
various  languages  and  run  on  various  computers. 

In  a  Kermit  file  transfer  communication  takes  place  over  ordinary  terminal 
connections.  Communication  is  asynchronous  and  half  duplex.  All  information 
is  sent  in  packets.  The  packet  length  is  variable,  but  the  maximum  is  96 
characters.  Packets  are  sent  in  alternate  directions,  and  each  packet 
requires  a  reply. 

All  transmission  is  in  ASCII  (see  Appendix  A  above).  Unprintable  ASCII 
characters  are  prefixed  with  a  special  character  and  then  converted  to 
printable  characters  during  transmission,  as  explained  below.  A  single  ASCII 
control  character,  normally  SOH  (1)  is  used  to  mark  the  beginning  of  a  packet. 
Lines  in  text  files  are  terminated  during  transmission  with  prefixed  carriage 
return/linefeed  sequences,  which  are  transparent  to  the  protocol  and  may 
appear  anywhere  in  the  data  in  the  packet. 

Only  a  file's  name  and  contents  are  transmitted.  File  attributes  are  not. 

The  simplicity  and  generality  of  the  protocol  allow  Kermit  on  any  machine  to 
communicate  with  Kermit  on  any  other  machine;  microcomputer  with  mainframe, 
microcomputer  with  microcomputer,  mainframe  with  mainframe  (not  to  mention 
minicomputers) .  The  back -and -forth  exchange  of  packets  keeps  the  two  sides 
synchronized,  while  the  communications  hardware  operates  asynchronously. 

Each  packet  starts  with  the  mark  character  and  contains  a  character  specifying 
each  of  the  following:  packet  length,  packet  sequence  number,  packet  type,  and 
checksum.  Data  (if  any)  goes  between  the  type  and  the  checksum.  The  length 
and  sequence  values  are  increased  by  32  to  ensure  that  they  are  printable. 

The  Kermit  packet  format  looks  like  this: 


!  MABX  !  pr(LEN)  !  pr(SEQ)  !  TYPE  i  DATA  !  CHECK  ! 


where  the  pr  function  converts  a  number  in  the  range  0  to  94  to  a  printable 
ASCII  character  by  adding  32. 

The  packet  length  (LEX),  which  does  not  include  the  MASK  and  LEN  fields,  can 
be  up  to  94  characters.  Sender  and  receiver  have  to  agree  on  the  maximum 
length.  The  packet  sequence  number  (SKQ)  goes  from  0  to  63,  and  then  recycles 


to  0.  The  sender  increases  it  by  1  each  tisM  the  receiver  acknowledges  a 
packet  reception. 

Commonly  used  packet  types  are: 

D  Data 
T  Acknowledge 
M  Negative  Acknowledge 
S  Send  Initiate 
B  Receive  Initiate 
B  Break  Transmission  (EOT) 

F  File  Header 
Z  End  of  File 
E  Error 

CHECK  may  be  one,  two  or  three  characters.  It  is  based  on  all  the  characters 
in  the  packet,  except  MARX  and  CHECK.  The  method  of  computing  CHECK  depends 
on  the  implementation.  One  method  is  to  get  the  sum  of  the  ASCII  codes, 
isolate  the  low-order  six  bits,  add  to  this  the  value  of  the  next  two  bits, 
and  apply  the  pr  function  to  the  low-order  six  bits  of  the  sum. 

Sender  and  receiver  use  the  same  CHECK  computation  method.  The  receiver 
computes  CHECK  from  the  contents  of  the  packet  received.  If  it  agrees  with 
the  one  sent,  the  receiver  sends  back  an  acknowledge  (ACK)  packet.  If  not, 
the  receiver  sends  a  negative  acknowledge  (NAK)  packet.  If  the  sender 
receives  a  NAK  packet,  or  does  not  receive  an  ACK  packet  soon  enough,  the 
unacknowledged  packet  is  sent  again.  If  the  number  of  attempts  to  send  a 
packet  exceeds  the  limit,  the  sender  terminates  the  transfer. 

Kermit  uses  PREFIXING  to  handle  unprintable  characters  and  to  do  rudimentary 
data  compression.  In  order  to  make  each  data  character  in  the  packet 
printable,  Kermit  prefixes,  or  quotes,  each  unprintable  character  by 
transforming  it  into  a  printable  one  and  preceding  it  with  by  a  special  prefix 
character,  normally  •.  The  transformation  is  done  by  altering  the  seventh 
bit.  (This  is  not  the  pr  function,  since  the  value  of  the  seventh  bit  is  64, 
and  in  one  case  it  is  subtracted.)  Thus  Control-A  (1)  becomes  *A  and  carriage 
return  (13)  becomes  SM.  Where  the  prefix  character  •  is  part  of  the  text,  it 
is  prefixed  with  itself:  *•.  The  unprintable  characters  are  the  control 
characters  and  DEL  (0  through  31  and  127).  Printable  characters  are  not 
transformed.  The  Kermit  processor  receiving  the  file  performs  the  reverse 
transformation. 

DATA  COMPRESSION  is  done  by  replacing  repeated  characters  by  the  repeat  count 
prefix  character  ~  (tilde),  followed  by  a  repeat  count  character,  followed  by 
the  character  repeated.  The  count  is  encoded  printably  by  using  the  pr 
function.  For  example,  ~) A  represents  a  series  of  93  letter  As,  and  ~H*B 
represents  a  series  of  40  Control-Bs.  Where  the  repeat  count  prefix  character 
is  part  of  the  text,  it  is  prefixed  with  •.  Thus  ~W*"  stands  for  55  tildes. 

Consider  an  errorless  file  transfer  between  two  Kermit  processors,  Kermit  1 
and  Kermit  2.  Kermit  1  initiates  the  transfer  by  sending  an  S  or  B  packet 
specifying  what  it  wants  to  do  (send  or  receive)  and  some  variable  values, 
such  as  maximum  packet  size  and  end  of  line  character.  Kermit  2  sends  an  ACK 
packet  specifying  its  variable  values.  Kermit  1  sends  an  F  packet  naming  the 
file  to  be  transferred.  Kermit  2  acknowledges.  Kermit  1  sends  the  contents 


of  the  file  in  D  packets.  Kermit  2  acknowledges  each.  Xernit  1  sends  a  Z  and 
a  B  packet.  Kermit  2  acknowledges  each.  Finally,  both  Kermits  terminate. 


We  end  this  appendix  by  showing  the  packets  used  to  transfer  a  file  called 
KEBMMAME  from  a  PC  to  a  mainframe.  XERMNAME  contains  these  seven  lines: 


Kermit  is  not  an  acronym.  It  was  named 
after  Kermit  the  Frog,  star  of  the 
television  series,  The  Muppet  Show. 

Deed  by  permission  of  Henderson 
Associates  Inc. 


The  packet  exchange  was  as  follows: 

s:  ,  Sn,  #-*&l“ ! ! 
r:  ,  Yn,  •-*  ~0! 

s:  ♦ I FKERMNAMEE I 
r:  *  I Y  V, 

s:  h'D~*  ~4»*M*JKermit  is  not  an  acronym.  It  was  named»M*Jaf ter  Kermit  the*! 
r:  •-Y#: 

8:  h*D  Frog,  star  of  the*M* Jtelevision  series,  The  lluppet  Show.eutJUsed  by  Cl 
r:  i#YA! 

s:  [SOpermission  of  Henderson*M*JAssociates  Inc.*M*J~*  ~4**M*JZ: 
r:  »SYBI 
s:  *AtXZD: 
r:  tXYC! 

s:  "A*fcB- ! 

r:  *&YD: 

where  we  indicate  to  the  left  of  each  packet  whether  its  originator  is  the 
sender  or  receiver  of  the  file,  we  do  not  show  the  mark  character,  and  we  put 
a  I  character  immediately  after  each  packet,  in  case  the  checksum  is  a  space. 
The  first  two  packets  specify,  for  example,  that  the  maximum  packet  length  is 
78  (n) ,  and  that  the  end  of  line  character  is  carriage  return  (-).  In  this 
transfer,  the  sending  Kermit  program  was  not  Crosstalk  but  IS-Kermit,  and  the 
receiving  computer  was  not  running  under  Unix. 
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